|
|
/*++
Copyright (c) 1994 Microsoft Corporation
Module Name:
registry.cxx
Abstract:
Functions to read/write registry parameters
Contents: EnsureInternetSettingsKeyCached CloseInternetSettingsKey GetMyEmailName InternetGetComputerName InternetDeleteRegistryValue InternetReadRegistryDword InternetWriteRegistryDword InternetReadRegistryString InternetWriteRegistryString InternetReadRegistryBinary (InternetReadRegistryDwordKey) (InternetReadRegistryStringKey) (InternetReadRegistryBinaryKey) (InternetGetPrivateProfileString) (ReadRegistryOemString) (WriteRegistryDword) ReadRegistryDword GetFileExtensionFromMimeType CreateMimeExclusionTableForCache DestroyMimeExclusionTableForCache CreateHeaderExclusionTableForCache DestroyHeaderExclusionTableForCache (CreateTableFromRegistryList) (CreateStringArrayFromDelimitedList)
Author:
Richard L Firth (rfirth) 20-Mar-1995
Environment:
Win32(s) user-level DLL
Revision History:
20-Mar-1995 rfirth Created
--*/
#include <wininetp.h>
char vszDelimiters[] = ";, ";
//
// manifests
//
#define INTERNET_CLIENT_KEY "Internet Settings"
#define SYSTEM_INI_FILE_NAME "SYSTEM.INI"
#define NETWORK_SECTION_NAME "Network"
#define COMPUTER_NAME_VALUE "ComputerName"
#define PROFILE_INT_BUFFER_LENGTH 128
#define MIME_TO_FILE_EXTENSION_KEY "MIME\\Database\\Content Type\\"
#define EXTENSION_VALUE "Extension"
//
// private prototypes
//
PRIVATE DWORD InternetReadRegistryDwordKey( IN HKEY ParameterKey, IN LPCSTR ParameterName, OUT LPDWORD ParameterValue );
PRIVATE DWORD InternetReadRegistryStringKey( IN HKEY ParameterKey, IN LPCSTR ParameterName, OUT LPSTR ParameterValue, IN OUT LPDWORD ParameterLength );
//PRIVATE
//DWORD
//InternetReadRegistryBinaryKey(
// IN HKEY ParameterKey,
// IN LPCSTR ParameterName,
// OUT LPBYTE ParameterValue,
// IN OUT LPDWORD ParameterLength
// );
//
//PRIVATE
//DWORD
//InternetGetPrivateProfileString(
// IN LPSTR IniFileName,
// IN LPSTR SectionName,
// IN LPCSTR ParameterName,
// OUT LPSTR ParameterValue,
// IN OUT LPDWORD ParameterLength
// );
PRIVATE DWORD ReadRegistryOemString( IN HKEY Key, IN LPCSTR ParameterName, OUT LPSTR String, IN OUT LPDWORD Length );
PRIVATE DWORD CreateTableFromRegistryList( IN LPSTR lpszParameter, // wininet registry parameter
OUT LPSTR *lplpszList, // Delimited List
OUT LPSTR **lplprgszTable, // Pointer table pointing into the list
OUT DWORD **lplpdwTableSizes, // Pointer to table containing sizes of string elements
OUT LPDWORD lpdwCount // count of elements in the table
);
PRIVATE DWORD CreateStringArrayFromDelimitedList( IN LPSTR lpszDelimitedList, IN LPSTR lpszDelimiters, IN LPSTR *lprgszStringArray, OUT LPDWORD lpdwCount );
PRIVATE DWORD WriteRegistryDword( IN HKEY Key, IN LPCSTR ParameterName, IN DWORD ParameterValue );
//
// private data
//
PRIVATE CRefdKey* g_prkInternetSettings = NULL;
//
// functions
//
CRefdKey* OpenInternetSettingsKey( VOID ) { CRefdKey* prk = NULL; HKEY hkInternetSettings = NULL; DWORD dwDisposition;
REGCREATEKEYEX(HKEY_CURRENT_USER, INTERNET_SETTINGS_KEY, 0, // reserved
NULL, // class
0, // options
KEY_READ | KEY_WRITE, NULL, // security attributes
&hkInternetSettings, &dwDisposition );
if (hkInternetSettings) { prk = new CRefdKey(hkInternetSettings);
if (!prk) { // we failed to create a ref'd key, so close the key we opened
REGCLOSEKEY(hkInternetSettings); } }
return prk; }
CRefdKey* GetInternetSettingsKey( VOID ) { CRefdKey* prk;
EnterCriticalSection(&GeneralInitCritSec);
prk = g_prkInternetSettings; if (prk) { prk->AddRef(); } else { prk = OpenInternetSettingsKey(); if (prk) { // addref once more for sticking in in the global
prk->AddRef();
// cache this value in the global
g_prkInternetSettings = prk; } }
LeaveCriticalSection(&GeneralInitCritSec);
return prk; }
VOID EnsureInternetSettingsKeyCached( VOID )
/*++
Routine Description:
Ensures that the registry key for the Internet Settings branch is cached and ready to be used
Arguments:
None.
Return Value:
None.
--*/
{ CRefdKey* prk;
DEBUG_ENTER((DBG_REGISTRY, None, "EnsureInternetSettingsKeyCached", NULL ));
// just get the key and release it to ensure that it has been cached in g_prkInternetSettings
prk = GetInternetSettingsKey(); if (prk) { prk->Release(); } }
DWORD CloseInternetSettingsKey( VOID )
/*++
Routine Description:
Closes Internet Settings registry key
Arguments:
None.
Return Value:
DWORD Success - ERROR_SUCCESS
Failure -
--*/
{ DEBUG_ENTER((DBG_REGISTRY, Dword, "CloseInternetSettingsKey", NULL ));
CRefdKey* prk;
EnterCriticalSection (&GeneralInitCritSec);
prk = g_prkInternetSettings; if (prk) { g_prkInternetSettings = NULL;
prk->Release(); }
LeaveCriticalSection (&GeneralInitCritSec);
DEBUG_LEAVE(ERROR_SUCCESS);
return ERROR_SUCCESS; }
DWORD GetMyEmailName( OUT LPSTR EmailName, IN OUT LPDWORD Length )
/*++
Routine Description:
Retrieve the user's email name from the appropriate place in the registry
Arguments:
EmailName - place to store email name
Length - IN: length of EmailName OUT: returned length of EmailName (in characters, minus trailing NUL)
Return Value:
DWORD Success - ERROR_SUCCESS
Failure - ERROR_FILE_NOT_FOUND ERROR_PATH_NOT_FOUND
--*/
{ DEBUG_ENTER((DBG_REGISTRY, Dword, "GetMyEmailName", "%#x, %#x [%d]", EmailName, Length, *Length ));
DWORD error;
//
// for the EmailName, we first try HKEY_CURRENT_USER. If that fails then we
// try the same branch of the HKEY_LOCAL_MACHINE tree. If that fails,
// invent something
//
static HKEY KeysToTry[2] = {HKEY_CURRENT_USER, HKEY_LOCAL_MACHINE}; int i;
//
// in the event we cannot find EmailName in both HKEY_CURRENT_USER and
// HKEY_LOCAL_MACHINE trees, then we return this default
//
static char DefaultEmailName[] = DEFAULT_EMAIL_NAME;
for (i = 0; i < ARRAY_ELEMENTS(KeysToTry); ++i) { error = InternetReadRegistryStringKey(KeysToTry[i], "EmailName", EmailName, Length ); if (error == ERROR_SUCCESS) { break; } } if (error != ERROR_SUCCESS) { if (IsPlatformWinNT()) {
//
// only NT supports GetUserName()
//
if (GetUserName(EmailName, Length)) {
//
// we return the length as if the result from strlen/wcslen
//
*Length -= sizeof(char);
DEBUG_PRINT(REGISTRY, INFO, ("GetUserName() returns %q\n", EmailName ));
error = ERROR_SUCCESS; } else {
//
// BUGBUG - what's the required length?
//
error = GetLastError(); } } else {
//
// Win95 & Win32s: have to do something different
//
}
//
// if we still don't have an email name, we use an internal default
//
if (error != ERROR_SUCCESS) {
DEBUG_PRINT(REGISTRY, ERROR, ("Cannot find EmailName: using default (%s)\n", DefaultEmailName ));
if (*Length >= sizeof(DEFAULT_EMAIL_NAME)) { memcpy(EmailName, DefaultEmailName, sizeof(DEFAULT_EMAIL_NAME));
//
// success - returned length as if from strlen()
//
*Length = sizeof(DEFAULT_EMAIL_NAME) - 1; error = ERROR_SUCCESS; } else {
//
// failure - returned length is the required buffer size
//
*Length = sizeof(DEFAULT_EMAIL_NAME); error = ERROR_INSUFFICIENT_BUFFER; } } }
DEBUG_LEAVE(error);
return error; }
//
//DWORD
//InternetGetComputerName(
// OUT LPSTR Buffer,
// IN OUT LPDWORD Length
// )
//
///*++
//
//Routine Description:
//
// Platform-dependent function that returns this computer's name
//
//Arguments:
//
// Buffer - pointer to buffer where name is returned
//
// Length - IN: number of bytes in Buffer
// OUT: number of characters in computer name, exluding terminating
// NUL
//
//Return Value:
//
// DWORD
// Success - ERROR_SUCCESS
//
// Failure - Win32 error
//
//--*/
//
//{
// DWORD error;
//
// if (IsPlatformWin32s()) {
// error = InternetGetPrivateProfileString(SYSTEM_INI_FILE_NAME,
// NETWORK_SECTION_NAME,
// COMPUTER_NAME_VALUE,
// Buffer,
// Length
// );
// } else {
// if (GetComputerName(Buffer, Length)) {
// error = ERROR_SUCCESS;
// } else {
// error = GetLastError();
// }
// }
// return error;
//}
PUBLIC DWORD InternetDeleteRegistryValue( IN LPSTR ParameterName )
/*++
Routine Description:
Delets an entry from a the Internet Client registry key if the platform is NT/Win95.
Arguments:
ParameterName - name of the parameter to retrieve (e.g. AccessType)
Return Value:
DWORD Success - ERROR_SUCCESS
Failure - ERROR_PATH_NOT_FOUND
--*/
{ DWORD error;
DEBUG_ENTER((DBG_REGISTRY, Dword, "InternetDeleteRegistryValue", "%q", ParameterName ));
HKEY clientKey;
//
// open the registry key containing the Internet client values (this is
// in the same place on NT and Win95)
//
error = REGOPENKEYEX(HKEY_CURRENT_USER, INTERNET_SETTINGS_KEY, 0, // reserved
KEY_ALL_ACCESS, &clientKey );
if (error == ERROR_SUCCESS) {
error = RegDeleteValue(clientKey, ParameterName );
REGCLOSEKEY(clientKey); }
DEBUG_LEAVE(error);
return error; }
DWORD InternetReadRegistryDword( IN LPCSTR ParameterName, OUT LPDWORD ParameterValue )
/*++
Routine Description:
Reads a single DWORD from a the Internet Client registry key if the platform is NT/Win95, else reads the value from SYSTEM.INI if we are running on Win32s
Arguments:
ParameterName - name of the parameter to retrieve (e.g. AccessType)
ParameterValue - pointer to place to store retrieved value
Return Value:
DWORD Success - ERROR_SUCCESS
Failure - ERROR_PATH_NOT_FOUND
--*/
{ DEBUG_ENTER((DBG_REGISTRY, Dword, "InternetReadRegistryDword", "%q, %x", ParameterName, ParameterValue ));
DWORD error = InternetReadRegistryDwordKey(HKEY_CURRENT_USER, ParameterName, ParameterValue );
DEBUG_LEAVE(error);
return error; }
#ifdef WININET6
DWORD InternetIDEWriteRegistryDword( IN LPCSTR ParameterName, IN DWORD ParameterValue )
/*++
Routine Description:
Writes a single DWORD from to the Internet Client registry key if the platform is NT/Win95, otherwise it fails.
Arguments:
ParameterName - name of the parameter to retrieve (e.g. AccessType)
ParameterValue - value to store in registry.
Return Value:
DWORD Success - ERROR_SUCCESS
Failure - ERROR_PATH_NOT_FOUND
--*/
{ DEBUG_ENTER((DBG_REGISTRY, Dword, "InternetIDEWriteRegistryDword", "%q, %x", ParameterName, ParameterValue ));
DWORD error = GlobalIdentity ? WriteIDRegDword(ParameterName, ParameterValue) : InternetWriteRegistryDword(ParameterName, ParameterValue);
DEBUG_LEAVE(error);
return error; }
DWORD InternetIDEReadRegistryDword( IN LPCSTR ParameterName, OUT LPDWORD ParameterValue )
/*++
Routine Description:
If we're in an identity-mode, we'll read from the special location. Otherwise, read from the old location.
Arguments:
ParameterName - name of the parameter to retrieve (e.g. AccessType)
ParameterValue - pointer to place to store retrieved value
Return Value:
DWORD Success - ERROR_SUCCESS
Failure - ERROR_PATH_NOT_FOUND
--*/
{ DEBUG_ENTER((DBG_REGISTRY, Dword, "InternetIDEReadRegistryDword", "%q, %x", ParameterName, ParameterValue ));
DWORD error = GlobalIdentity ? ReadIDRegDword(ParameterName, ParameterValue) : InternetReadRegistryDwordKey(HKEY_CURRENT_USER, ParameterName, ParameterValue);
DEBUG_LEAVE(error);
return error; } #endif
DWORD InternetCacheReadRegistryDword( IN LPCSTR ParameterName, OUT LPDWORD ParameterValue )
/*++
Routine Description:
Reads a single DWORD from a the Internet Client registry key if the platform is NT/Win95, else reads the value from SYSTEM.INI if we are running on Win32s
Arguments:
ParameterName - name of the parameter to retrieve (e.g. AccessType)
ParameterValue - pointer to place to store retrieved value
Return Value:
DWORD Success - ERROR_SUCCESS
Failure - ERROR_PATH_NOT_FOUND
--*/
{ DEBUG_ENTER((DBG_REGISTRY, Dword, "InternetCacheReadRegistryDword", "%q, %x", ParameterName, ParameterValue ));
DWORD error = ERROR_SUCCESS; HKEY clientKey;
error = REGOPENKEYEX(HKEY_CURRENT_USER, INTERNET_CACHE_SETTINGS_KEY, 0, // reserved
KEY_QUERY_VALUE, &clientKey );
if (error == ERROR_SUCCESS) { error = ReadRegistryDword(clientKey, ParameterName, ParameterValue ); REGCLOSEKEY(clientKey); }
DEBUG_LEAVE(error);
return error; }
DWORD InternetWriteRegistryDword( IN LPCSTR ParameterName, IN DWORD ParameterValue )
/*++
Routine Description:
Writes a single DWORD from to the Internet Client registry key if the platform is NT/Win95, otherwise it fails.
Arguments:
ParameterName - name of the parameter to retrieve (e.g. AccessType)
ParameterValue - value to store in registry.
Return Value:
DWORD Success - ERROR_SUCCESS
Failure - ERROR_PATH_NOT_FOUND
--*/
{ DEBUG_ENTER((DBG_REGISTRY, Dword, "InternetWriteRegistryDword", "%q, %x", ParameterName, ParameterValue ));
DWORD error; CRefdKey* prk = GetInternetSettingsKey();
if (prk != NULL) { error = WriteRegistryDword(prk->GetKey(), ParameterName, ParameterValue ); prk->Release();
} else { error = ERROR_SUCCESS; }
DEBUG_PRINT(REGISTRY, INFO, ("InternetWriteRegistryDword(%q): value = %d (%#x)\n", ParameterName, ParameterValue, ParameterValue ));
DEBUG_LEAVE(error);
return error; }
DWORD InternetReadRegistryString( IN LPCSTR ParameterName, OUT LPSTR ParameterValue, IN OUT LPDWORD ParameterLength )
/*++
Routine Description:
Reads a string from the Internet Client registry key on NT/Win95, or reads the corresponding value from SYSTEM.INI on a Win32s platform
Arguments:
ParameterName - name of value parameter within key (e.g. EmailName)
ParameterValue - pointer to string buffer for returned string
ParameterLength - IN: number of bytes in ParameterValue OUT: number of bytes in string (excluding trailing '\0')
Return Value:
DWORD Success - ERROR_SUCCESS
Failure - ERROR_PATH_NOT_FOUND
--*/
{ DEBUG_ENTER((DBG_REGISTRY, Dword, "InternetReadRegistryString", "%q, %x, %x [%d]", ParameterName, ParameterValue, ParameterLength, *ParameterLength ));
DWORD error = InternetReadRegistryStringKey(HKEY_CURRENT_USER, ParameterName, ParameterValue, ParameterLength );
DEBUG_LEAVE(error);
return error; }
//
//DWORD
//InternetWriteRegistryString(
// IN LPCSTR ParameterName,
// IN LPSTR ParameterValue
// )
//
///*++
//
//Routine Description:
//
// Writes a string to the Internet Client registry key on NT/Win95, or writes
// the corresponding value to SYSTEM.INI on Win32s platform
//
//Arguments:
//
// ParameterName - name of value parameter within key (e.g. EmailName)
//
// ParameterValue - pointer to string to write
//
//Return Value:
//
// DWORD
// Success - ERROR_SUCCESS
//
// Failure -
//
//--*/
//
//{
// DEBUG_ENTER((DBG_REGISTRY,
// Dword,
// "InternetWriteRegistryString",
// "%.40q, %.80q",
// ParameterName,
// ParameterValue
// ));
//
// DWORD error;
//
// if (IsPlatformWin32s()) {
//
// BOOL ok;
//
// ok = WritePrivateProfileString(INTERNET_CLIENT_KEY,
// ParameterName,
// ParameterValue,
// SYSTEM_INI_FILE_NAME
// );
// error = ok ? ERROR_SUCCESS : GetLastError();
// } else {
//
// //
// // BUGBUG - currently, nothing needs to write to registry if NT or Win95
// //
//
// INET_ASSERT(FALSE);
//
// }
//
// DEBUG_LEAVE(error);
//
// return error;
//}
//
//
//DWORD
//InternetReadRegistryBinary(
// IN LPCSTR ParameterName,
// OUT LPBYTE ParameterValue,
// IN OUT LPDWORD ParameterLength
// )
//
///*++
//
//Routine Description:
//
// Reads a binary value from the Internet Client registry key on NT/Win95, or
// reads the corresponding value from SYSTEM.INI on a Win32s platform
//
//Arguments:
//
// ParameterName - name of value parameter within key (e.g. EmailName)
//
// ParameterValue - pointer to buffer for returned data
//
// ParameterLength - IN: number of bytes in ParameterValue
// OUT: number of bytes in buffer, or required size
//
//Return Value:
//
// DWORD
// Success - ERROR_SUCCESS
//
// Failure - ERROR_PATH_NOT_FOUND
// The parameter wasn't found
//
// ERROR_MORE_DATA
// The buffer isn't large enough
//
//--*/
//
//{
// DEBUG_ENTER((DBG_REGISTRY,
// Dword,
// "InternetReadRegistryBinary",
// "%q, %#x, %#x [%d]",
// ParameterName,
// ParameterValue,
// ParameterLength,
// *ParameterLength
// ));
//
// DWORD error;
//
// error = InternetReadRegistryBinaryKey(HKEY_CURRENT_USER,
// ParameterName,
// ParameterValue,
// ParameterLength
// );
//
// DEBUG_LEAVE(error);
//
// return error;
//}
//
// private functions
//
PUBLIC DWORD InternetReadRegistryDwordKey( IN HKEY ParameterKey, IN LPCSTR ParameterName, OUT LPDWORD ParameterValue )
/*++
Routine Description:
Reads a single DWORD from a the Internet Client registry key if the platform is NT/Win95, else reads the value from SYSTEM.INI if we are running on Win32s.
Does not modify the *ParameterValue if the registry variable cannot be read
Arguments:
ParameterKey - root registry key (e.g. HKEY_CURRENT_USER)
ParameterName - name of the parameter to retrieve (e.g. AccessType)
ParameterValue - pointer to place to store retrieved value
Return Value:
DWORD Success - ERROR_SUCCESS
Failure - ERROR_PATH_NOT_FOUND
--*/
{ DEBUG_ENTER((DBG_REGISTRY, Dword, "InternetReadRegistryDwordKey", "%s, %q, %x", (ParameterKey == HKEY_LOCAL_MACHINE) ? "HKEY_LOCAL_MACHINE" : (ParameterKey == HKEY_CURRENT_USER) ? "HKEY_CURRENT_USER" : "???", ParameterName, ParameterValue ));
DWORD error = ERROR_SUCCESS; CRefdKey* prk = GetInternetSettingsKey(); BOOL bOpenedKey = FALSE; HKEY hkSettings = NULL;
if (ParameterKey != HKEY_CURRENT_USER) { error = REGOPENKEYEX(ParameterKey, INTERNET_SETTINGS_KEY, 0, // reserved
KEY_QUERY_VALUE, &hkSettings ); if (error == ERROR_SUCCESS) { bOpenedKey = TRUE; } } else if (prk) { hkSettings = prk->GetKey(); } else { error = ERROR_PATH_NOT_FOUND; }
if (error == ERROR_SUCCESS) { error = ReadRegistryDword(hkSettings, ParameterName, ParameterValue ); } if (bOpenedKey) { REGCLOSEKEY(hkSettings); }
if (prk) { prk->Release(); }
DEBUG_PRINT(REGISTRY, INFO, ("InternetReadRegistryDwordKey(%q): value = %d (%#x)\n", ParameterName, *ParameterValue, *ParameterValue ));
DEBUG_LEAVE(error);
return error; }
PRIVATE DWORD InternetReadRegistryStringKey( IN HKEY ParameterKey, IN LPCSTR ParameterName, OUT LPSTR ParameterValue, IN OUT LPDWORD ParameterLength )
/*++
Routine Description:
Reads a string from the Internet Client registry key on NT/Win95, or reads the corresponding value from SYSTEM.INI on a Win32s platform
Arguments:
ParameterKey - root registry key (e.g. HKEY_LOCAL_MACHINE)
ParameterName - name of value parameter within key (e.g. EmailName)
ParameterValue - pointer to string buffer for returned string
ParameterLength - IN: number of bytes in ParameterValue OUT: number of bytes in string (excluding trailing '\0')
Return Value:
DWORD Success - ERROR_SUCCESS
Failure - ERROR_PATH_NOT_FOUND
--*/
{ DEBUG_ENTER((DBG_REGISTRY, Dword, "InternetReadRegistryStringKey", "%s (%x), %q, %x, %x [%d]", (ParameterKey == HKEY_LOCAL_MACHINE) ? "HKEY_LOCAL_MACHINE" : (ParameterKey == HKEY_CURRENT_USER) ? "HKEY_CURRENT_USER" : "???", ParameterKey, ParameterName, ParameterValue, ParameterLength, *ParameterLength ));
//
// zero-terminate the string
//
if (*ParameterLength > 0) { *ParameterValue = '\0'; }
DWORD error = ERROR_SUCCESS; CRefdKey* prk = GetInternetSettingsKey(); BOOL bOpenedKey = FALSE; HKEY hkSettings = NULL;
if (ParameterKey != HKEY_CURRENT_USER) { error = REGOPENKEYEX(ParameterKey, INTERNET_SETTINGS_KEY, 0, // reserved
KEY_QUERY_VALUE, &hkSettings ); if (error == ERROR_SUCCESS) { bOpenedKey = TRUE; } } else if (prk) { hkSettings = prk->GetKey(); } else { error = ERROR_PATH_NOT_FOUND; }
if (error == ERROR_SUCCESS) { error = ReadRegistryOemString(hkSettings, ParameterName, ParameterValue, ParameterLength ); } if (bOpenedKey) { REGCLOSEKEY(hkSettings); }
if (prk) { prk->Release(); }
DEBUG_PRINT(REGISTRY, INFO, ("InternetReadRegistryStringKey(%q): value = %q\n", ParameterName, ParameterValue ));
DEBUG_LEAVE(error);
return error; }
//
//PRIVATE
//DWORD
//InternetReadRegistryBinaryKey(
// IN HKEY ParameterKey,
// IN LPCSTR ParameterName,
// OUT LPBYTE ParameterValue,
// IN OUT LPDWORD ParameterLength
// )
//
///*++
//
//Routine Description:
//
// Reads a binary value from the Internet Client registry key on NT/Win95, or
// reads the corresponding value from SYSTEM.INI on a Win32s platform
//
//Arguments:
//
// ParameterKey - root registry key (e.g. HKEY_LOCAL_MACHINE)
//
// ParameterName - name of value parameter within key (e.g. EmailName)
//
// ParameterValue - pointer to buffer for returned data
//
// ParameterLength - IN: number of bytes in ParameterValue
// OUT: number of bytes in buffer, or required size
//
//Return Value:
//
// DWORD
// Success - ERROR_SUCCESS
//
// Failure - ERROR_PATH_NOT_FOUND
// The parameter wasn't found
//
// ERROR_MORE_DATA
// The buffer isn't large enough
//
//--*/
//
//{
// DEBUG_ENTER((DBG_REGISTRY,
// Dword,
// "InternetReadRegistryBinaryKey",
// "%s (%x), %q, %#x, %#x [%d]",
// (ParameterKey == HKEY_LOCAL_MACHINE)
// ? "HKEY_LOCAL_MACHINE"
// : (ParameterKey == HKEY_CURRENT_USER)
// ? "HKEY_CURRENT_USER"
// : "???",
// ParameterKey,
// ParameterName,
// ParameterValue,
// ParameterLength,
// *ParameterLength
// ));
//
// DWORD error;
// HKEY clientKey;
//
// //
// // open the registry key containing the Internet client values (this is
// // in the same place on NT and Win95)
// //
//
// error = REGOPENKEYEX(ParameterKey,
// INTERNET_SETTINGS_KEY,
// 0, // reserved
// KEY_QUERY_VALUE,
// &clientKey
// );
//
// if (error == ERROR_SUCCESS) {
//
// DWORD valueType;
//
// error = RegQueryValueEx(clientKey,
// ParameterName,
// NULL, // reserved
// &valueType,
// ParameterValue,
// ParameterLength
// );
// REGCLOSEKEY(clientKey);
// }
//
// DEBUG_PRINT(REGISTRY,
// INFO,
// ("InternetReadRegistryBinaryKey(%q): length = %d\n",
// ParameterName,
// *ParameterLength
// ));
//
// DEBUG_LEAVE(error);
//
// return error;
//}
//
//
//PRIVATE
//DWORD
//InternetGetPrivateProfileString(
// IN LPSTR IniFileName,
// IN LPSTR SectionName,
// IN LPCSTR ParameterName,
// OUT LPSTR ParameterValue,
// IN OUT LPDWORD ParameterLength
// )
//
///*++
//
//Routine Description:
//
// Reads an string out of an INI file. Mainly just for Win32s
//
//Arguments:
//
// IniFileName - name of INI file to read
//
// SectionName - name of section in INI file to read
//
// ParameterName - name of entry in section to read
//
// ParameterValue - returned string
//
// ParameterLength - IN: Length of ParameterValue
// OUT: Number of characters in ParameterValue, excluding
// terminating NUL
//
//Return Value:
//
// DWORD
// Success - ERROR_SUCCESS
//
// Failure - ERROR_PATH_NOT_FOUND
// ERROR_FILE_NOT_FOUND
//
//--*/
//
//{
// DWORD error;
// DWORD nChars;
//
// nChars = GetPrivateProfileString(SectionName,
// ParameterName,
// "", // lpszDefault
// ParameterValue,
// *ParameterLength,
// IniFileName
// );
// if (nChars > 0) {
// *ParameterLength = nChars;
// error = ERROR_SUCCESS;
// } else {
// error = ERROR_PATH_NOT_FOUND;
// }
// return error;
//}
PRIVATE DWORD ReadRegistryOemString( IN HKEY Key, IN LPCSTR ParameterName, OUT LPSTR String, IN OUT LPDWORD Length )
/*++
Routine Description:
Reads a string out of the registry as an OEM string
Arguments:
Key - open registry key where to read value from
ParameterName - name of registry value to read
String - place to put it
Length - IN: length of String buffer in characters OUT: length of String in characters, as if returned from strlen()
Return Value:
DWORD Success - ERROR_SUCCESS
Failure - ERROR_FILE_NOT_FOUND Couldn't find the parameter
ERROR_PATH_NOT_FOUND Couldn't find the parameter
ERROR_INTERNET_BAD_REGISTRY_PARAMETER Inconsistent registry contents
--*/
{ DEBUG_ENTER((DBG_REGISTRY, Dword, "ReadRegistryOemString", "%#x, %q, %#x, %#x [%d]", Key, ParameterName, String, Length, *Length ));
LONG error; DWORD valueType; LPSTR str; DWORD valueLength;
//
// first, get the length of the string
//
valueLength = *Length; error = RegQueryValueEx(Key, ParameterName, NULL, // reserved
&valueType, (LPBYTE)String, &valueLength ); if (error != ERROR_SUCCESS) { goto quit; }
//
// we only support REG_SZ (single string) values in this function
//
if (valueType != REG_SZ) { error = ERROR_INTERNET_BAD_REGISTRY_PARAMETER; goto quit; }
//
// if 1 or 0 chars returned then the string is empty
//
if (valueLength <= sizeof(char)) { error = ERROR_PATH_NOT_FOUND; goto quit; }
//
// convert the ANSI string to OEM character set in place. According to Win
// help, this always succeeds
//
CharToOem(String, String);
//
// return the length as if returned from strlen() (i.e. drop the '\0')
//
*Length = valueLength - sizeof(char);
DEBUG_PRINT(REGISTRY, INFO, ("ReadRegistryOemString(%q) returning %q (%d chars)\n", ParameterName, String, *Length ));
quit:
DEBUG_LEAVE(error);
return error; }
DWORD ReadRegistryDword( IN HKEY Key, IN LPCSTR ParameterName, OUT LPDWORD ParameterValue )
/*++
Routine Description:
Reads a DWORD parameter from the registry
Won't modify *ParameterValue unless a valid value is read from the registry
Arguments:
Key - handle of open registry key where parameter resides
ParameterName - name of DWORD parameter to read
ParameterValue - returned DWORD parameter read from registry
Return Value:
DWORD Success - ERROR_SUCCESS
Failure - ERROR_PATH_NOT_FOUND One of the following occurred: - the parameter is not in the specified registry key - the parameter is the wrong type - the parameter is the wrong size
--*/
{ DEBUG_ENTER((DBG_REGISTRY, Dword, "ReadRegistryDword", "%x, %q, %x", Key, ParameterName, ParameterValue ));
DWORD error; DWORD valueLength; DWORD valueType; DWORD value;
valueLength = sizeof(*ParameterValue); error = (DWORD)RegQueryValueEx(Key, ParameterName, NULL, // reserved
&valueType, (LPBYTE)&value, &valueLength );
//
// if the size or type aren't correct then return an error, else only if
// success was returned do we modify *ParameterValue
//
if (error == ERROR_SUCCESS) { if (((valueType != REG_DWORD) && (valueType != REG_BINARY)) || (valueLength != sizeof(DWORD))) {
DEBUG_PRINT(REGISTRY, ERROR, ("valueType = %d, valueLength = %d\n", valueType, valueLength ));
error = ERROR_PATH_NOT_FOUND; } else { *ParameterValue = value; } }
DEBUG_LEAVE(error);
return error; }
PRIVATE DWORD WriteRegistryDword( IN HKEY Key, IN LPCSTR ParameterName, IN DWORD ParameterValue )
/*++
Routine Description:
Writes a DWORD parameter from the registry
Will write ParameterValue to the key.
Arguments:
Key - handle of open registry key where parameter resides
ParameterName - name of DWORD parameter to write
ParameterValue - DWORD parameter to write from registry
Return Value:
DWORD Success - ERROR_SUCCESS
Failure - ERROR_PATH_NOT_FOUND One of the following occurred: - the parameter is not in the specified registry key - the parameter is the wrong type - the parameter is the wrong size
--*/
{ DEBUG_ENTER((DBG_REGISTRY, Dword, "WriteRegistryDword", "%x, %q, %x", Key, ParameterName, ParameterValue ));
DWORD error; DWORD valueLength; DWORD valueType; DWORD value;
valueLength = sizeof(ParameterValue); valueType = REG_DWORD; value = ParameterValue;
error = (DWORD)RegSetValueEx(Key, ParameterName, NULL, // reserved
valueType, (LPBYTE)&value, valueLength );
DEBUG_PRINT(REGISTRY, INFO, ("added: valueType = %d, valueLength = %d\n", valueType, valueLength ));
DEBUG_LEAVE(error);
return error; }
BOOL GetFileExtensionFromMimeType( LPCSTR lpszMimeType, DWORD dwMimeLen, LPSTR lpszFileExtension, LPDWORD lpdwExtLen ) { HKEY hKey = NULL; LPSTR lpszMimeKey = (LPSTR)_alloca(sizeof(MIME_TO_FILE_EXTENSION_KEY)+dwMimeLen);
memcpy(lpszMimeKey, MIME_TO_FILE_EXTENSION_KEY, sizeof(MIME_TO_FILE_EXTENSION_KEY)-1); memcpy(lpszMimeKey + sizeof(MIME_TO_FILE_EXTENSION_KEY) - 1, lpszMimeType, dwMimeLen); lpszMimeKey[sizeof(MIME_TO_FILE_EXTENSION_KEY) + dwMimeLen - 1] = '\0';
if (REGOPENKEYEX(HKEY_CLASSES_ROOT, lpszMimeKey, 0, KEY_QUERY_VALUE, &hKey)==ERROR_SUCCESS) { DWORD dwType, dwError = RegQueryValueEx(hKey, EXTENSION_VALUE, NULL, &dwType, (LPBYTE)lpszFileExtension, lpdwExtLen); REGCLOSEKEY(hKey); return (dwError==ERROR_SUCCESS); } return FALSE; }
DWORD CreateMimeExclusionTableForCache() { INET_ASSERT(lpvrgszMimeExclusionTable == NULL); INET_ASSERT(vszMimeExclusionList == NULL);
return (CreateTableFromRegistryList("MimeExclusionListForCache", &vszMimeExclusionList, &lpvrgszMimeExclusionTable, &lpvrgdwMimeExclusionTableOfSizes, &vdwMimeExclusionTableCount)); }
VOID DestroyMimeExclusionTableForCache() { if (lpvrgszMimeExclusionTable) {
INET_ASSERT(vszMimeExclusionList != NULL);
FREE_MEMORY(lpvrgszMimeExclusionTable); FREE_MEMORY(lpvrgdwMimeExclusionTableOfSizes); FREE_MEMORY(vszMimeExclusionList);
lpvrgszMimeExclusionTable = NULL; vszMimeExclusionList = NULL; vdwMimeExclusionTableCount = 0; } }
DWORD CreateHeaderExclusionTableForCache() { INET_ASSERT(lpvrgszHeaderExclusionTable == NULL); INET_ASSERT(vszHeaderExclusionList == NULL);
return (CreateTableFromRegistryList("HeaderExclusionListForCache", &vszHeaderExclusionList, &lpvrgszHeaderExclusionTable, NULL, &vdwHeaderExclusionTableCount));
}
VOID DestroyHeaderExclusionTableForCache() { if (lpvrgszHeaderExclusionTable) {
INET_ASSERT(vszHeaderExclusionList != NULL);
FREE_MEMORY(lpvrgszHeaderExclusionTable); FREE_MEMORY(vszHeaderExclusionList);
lpvrgszHeaderExclusionTable = NULL; vszHeaderExclusionList = NULL; vdwHeaderExclusionTableCount = 0; } }
PRIVATE DWORD CreateTableFromRegistryList( IN LPSTR lpszParameter, // wininet registry parameter
OUT LPSTR *lplpszList, // Delimited List
OUT LPSTR **lplprgszTable, // Pointer table pointing into the list
OUT DWORD **lplpdwTableSizes, // Pointer to table containing sizes of string elements
OUT LPDWORD lpdwCount // count of elements in the table
)
/*++
Routine Description:
Creates argv array from registry string
Arguments:
lpszParameter - wininet registry parameter
lplpszList - delimited List
lplprgszTable - pointer table pointing into the list
lplpdwTableSizes - pointer to table containing sizes of string elements
lpdwCount - count of elements in the table
Return Value:
DWORD Success - ERROR_SUCCESS
Failure - ERROR_NOT_ENOUGH_MEMORY ERROR_INVALID_PARAMETER
--*/
{ INET_ASSERT(lplpszList != NULL); INET_ASSERT(lplprgszTable != NULL);
DWORD dwLen = 0; DWORD error;
//
// let us find out the length of this string
//
error = InternetReadRegistryString(lpszParameter, NULL, &dwLen); if ((error != ERROR_SUCCESS) && (error != ERROR_MORE_DATA)) { return error; }
dwLen += 2; // for good measure
if (!(*lplpszList = (LPSTR)ALLOCATE_MEMORY(LPTR, dwLen))) { return ERROR_NOT_ENOUGH_MEMORY; }
error = InternetReadRegistryString(lpszParameter, *lplpszList, &dwLen);
//
// if it fails now, we need to bailout
//
if (error != ERROR_SUCCESS) { goto bailout; }
//
// now let us see how many elements are there in this list
//
error = CreateStringArrayFromDelimitedList(*lplpszList, vszDelimiters, NULL, lpdwCount ); if (!*lpdwCount) { error = ERROR_INVALID_PARAMETER; goto bailout; }
//
// let us allocate an array of pointers
//
if (!(*lplprgszTable = (LPSTR *)ALLOCATE_MEMORY(LPTR, *lpdwCount * sizeof(LPSTR)))) { error = ERROR_NOT_ENOUGH_MEMORY; goto bailout; }
error = CreateStringArrayFromDelimitedList(*lplpszList, vszDelimiters, *lplprgszTable, lpdwCount );
INET_ASSERT(*lpdwCount);
if ((lplpdwTableSizes == NULL) || (error != ERROR_SUCCESS)) { goto bailout; }
*lplpdwTableSizes = (LPDWORD)ALLOCATE_MEMORY(LPTR, (sizeof(DWORD)*(*lpdwCount)));
if (*lplpdwTableSizes == NULL) { error = ERROR_NOT_ENOUGH_MEMORY; goto bailout; }
DWORD i;
for (i = 0; i < *lpdwCount; i++) {
INET_ASSERT((*lplprgszTable)[i]);
(*lplpdwTableSizes)[i] = lstrlen((*lplprgszTable)[i]); }
bailout:
if (error != ERROR_SUCCESS) { if (*lplpszList) { FREE_MEMORY(*lplpszList); *lplpszList = NULL; } if (*lplprgszTable) { FREE_MEMORY(*lplprgszTable); *lplprgszTable = NULL; } }
return error; }
PRIVATE DWORD CreateStringArrayFromDelimitedList( IN LPSTR lpszDelimitedList, IN LPSTR lpszDelimiters, IN LPSTR *lprgszStringArray, OUT LPDWORD lpdwCount ) {
LPSTR lpStart, lpEnd, lpTmp; DWORD dwError = ERROR_INVALID_PARAMETER;
*lpdwCount = 0;
lpStart = lpszDelimitedList; lpEnd = lpStart + strlen(lpszDelimitedList); // points to null
// strip out the trailing spaces
for(;(lpStart<lpEnd);--lpEnd) { int c; c = (int)*(lpEnd-1); if (!isspace(c)) { *lpEnd = '\0'; break; } }
// bailout if this is an empty string
if (lpStart == lpEnd) { goto done; }
dwError = ERROR_SUCCESS;
for (lpTmp = lpStart;(lpTmp && (lpEnd > lpStart)); lpStart = lpTmp+1) { int c;
lpTmp = lpStart;
c = (int)*lpStart; if (isspace(c)) { continue; }
// when we come here there is a non space character
INET_ASSERT(!isspace(*lpStart));
lpTmp = strpbrk(lpStart, lpszDelimiters);
if (lprgszStringArray) {
if (lpTmp) { *lpTmp = 0; // create a string out of it
} // plug the start pointer into the array
lprgszStringArray[*lpdwCount] = lpStart; }
++*lpdwCount;
} done: return (dwError); }
#if INET_DEBUG
typedef struct { LIST_ENTRY entry; HKEY hkey; char * file; int line; char name[1]; } DBGREGKEYINFO;
SERIALIZED_LIST DbgRegKeyList;
VOID DbgRegKey_Init(VOID) { InitializeSerializedList(&DbgRegKeyList); }
VOID DbgRegKey_Terminate(VOID) { TerminateSerializedList(&DbgRegKeyList); }
void regkey_add(const char * name, HKEY hkey, char * file, int line) {
if (!name) { name = ""; }
int len = lstrlen(name); DBGREGKEYINFO * p = (DBGREGKEYINFO *)ALLOCATE_FIXED_MEMORY(sizeof(DBGREGKEYINFO) + len);
if (p) { //dprintf("Wininet.DbgRegKey: adding %q\n", name);
memcpy(p->name, name, len + 1); p->line = line; p->file = file; p->hkey = hkey; InsertAtHeadOfSerializedList(&DbgRegKeyList, &p->entry); } }
void regkey_remove(HKEY hkey) { LockSerializedList(&DbgRegKeyList);
DBGREGKEYINFO * p = (DBGREGKEYINFO *)HeadOfSerializedList(&DbgRegKeyList);
while (p != (DBGREGKEYINFO *)SlSelf(&DbgRegKeyList)) { if (p->hkey == hkey) { RemoveFromSerializedList(&DbgRegKeyList, (PLIST_ENTRY)p); //dprintf("Wininet.DbgRegKey: removing %q\n", p->name);
FREE_MEMORY(p); break; } p = (DBGREGKEYINFO *)p->entry.Flink; } UnlockSerializedList(&DbgRegKeyList); }
char * regkey_name(HKEY hkey, const char * subname) { switch ((INT_PTR)hkey) { case (INT_PTR)HKEY_CLASSES_ROOT: return NEW_STRING("HKEY_CLASSES_ROOT");
case (INT_PTR)HKEY_CURRENT_USER: return NEW_STRING("HKEY_CURRENT_USER");
case (INT_PTR)HKEY_LOCAL_MACHINE: return NEW_STRING("HKEY_LOCAL_MACHINE");
case (INT_PTR)HKEY_USERS: return NEW_STRING("HKEY_USERS");
case (INT_PTR)HKEY_PERFORMANCE_DATA: return NEW_STRING("HKEY_PERFORMANCE_DATA");
case (INT_PTR)HKEY_CURRENT_CONFIG: return NEW_STRING("HKEY_CURRENT_CONFIG");
case (INT_PTR)HKEY_DYN_DATA: return NEW_STRING("HKEY_DYN_DATA"); }
char * name = NULL;
LockSerializedList(&DbgRegKeyList);
DBGREGKEYINFO * p = (DBGREGKEYINFO *)HeadOfSerializedList(&DbgRegKeyList);
while (p != (DBGREGKEYINFO *)SlSelf(&DbgRegKeyList)) { if (p->hkey == hkey) {
int len = lstrlen(p->name); int slen = lstrlen(subname);
name = (char *)ALLOCATE_FIXED_MEMORY(len + 1 + slen + 1); if (name) { memcpy(name, p->name, len); name[len] = '\\'; memcpy(name + len + 1, subname, slen + 1); } break; } p = (DBGREGKEYINFO *)p->entry.Flink; } UnlockSerializedList(&DbgRegKeyList);
return name; }
void regkey_freename(char * name) { if (name) { FREE_MEMORY(name); } }
LONG DbgRegOpenKey( IN HKEY hKey, IN LPCTSTR lpszSubKey, OUT PHKEY phkResult, char * file, int line ) { char * keyname = regkey_name(hKey, lpszSubKey); LONG rc = RegOpenKey(hKey, lpszSubKey, phkResult);
if (rc == 0) { regkey_add(keyname, *phkResult, file, line); } regkey_freename(keyname); return rc; }
LONG DbgRegOpenKeyEx( IN HKEY hKey, IN LPCSTR lpSubKey, IN DWORD ulOptions, IN REGSAM samDesired, OUT PHKEY phkResult, char * file, int line ) { char * keyname = regkey_name(hKey, lpSubKey); LONG rc = RegOpenKeyEx(hKey, lpSubKey, ulOptions, samDesired, phkResult);
if (rc == 0) { regkey_add(keyname, *phkResult, file, line); } regkey_freename(keyname); return rc; }
LONG DbgRegCreateKeyEx( IN HKEY hKey, IN LPCSTR lpSubKey, IN DWORD Reserved, IN LPSTR lpClass, IN DWORD dwOptions, IN REGSAM samDesired, IN LPSECURITY_ATTRIBUTES lpSecurityAttributes, OUT PHKEY phkResult, OUT LPDWORD lpdwDisposition, char * file, int line ) { char * keyname = regkey_name(hKey, lpSubKey); LONG rc = RegCreateKeyEx(hKey, lpSubKey, Reserved, lpClass, dwOptions, samDesired, lpSecurityAttributes, phkResult, lpdwDisposition);
if (rc == 0) { regkey_add(keyname, *phkResult, file, line); } regkey_freename(keyname); return rc; }
LONG DbgRegCloseKey( IN HKEY hKey ) { LONG rc = RegCloseKey(hKey);
if (rc == 0) { regkey_remove(hKey); } return rc; }
#endif // INET_DEBUG
|