//==============================================================; // // This source code is only intended as a supplement to existing Microsoft documentation. // // // // // THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY // KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE // IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR // PURPOSE. // // Copyright (C) 1999 Microsoft Corporation. All Rights Reserved. // // // //==============================================================; #include #include #include "Registry.h" #define STRINGS_ONLY #include "globals.h" //////////////////////////////////////////////////////// // // Internal helper functions prototypes // // Set the given key and its value. BOOL setKeyAndValue(const _TCHAR* pszPath, const _TCHAR* szSubkey, const _TCHAR* szValue) ; // Set the given key and its value in the MMC Snapin location BOOL setSnapInKeyAndValue(const _TCHAR* szKey, const _TCHAR* szSubkey, const _TCHAR* szName, const _TCHAR* szValue); // Set the given valuename under the key to value BOOL setValue(const _TCHAR* szKey, const _TCHAR* szValueName, const _TCHAR* szValue); // Delete szKeyChild and all of its descendents. LONG recursiveDeleteKey(HKEY hKeyParent, const _TCHAR* szKeyChild) ; //////////////////////////////////////////////////////// // // Constants // // Size of a CLSID as a string //const int CLSID_STRING_SIZE = 39 ; ///////////////////////////////////////////////////////// // // Public function implementation // // // Register the component in the registry. // HRESULT RegisterServer(HMODULE hModule, // DLL module handle const CLSID& clsid, // Class ID const _TCHAR* szFriendlyName) // IDs { // Get server location. _TCHAR szModule[512] ; DWORD dwResult = ::GetModuleFileName(hModule, szModule, sizeof(szModule)/sizeof(_TCHAR)) ; assert(dwResult != 0) ; // Get CLSID LPOLESTR wszCLSID = NULL ; HRESULT hr = StringFromCLSID(clsid, &wszCLSID) ; assert(SUCCEEDED(hr)) ; MAKE_TSTRPTR_FROMWIDE(pszCLSID, wszCLSID); // Build the key CLSID\\{...} _TCHAR szKey[64] ; _tcscpy(szKey, _T("CLSID\\")) ; _tcscat(szKey, pszCLSID) ; // Add the CLSID to the registry. setKeyAndValue(szKey, NULL, szFriendlyName) ; // Add the server filename subkey under the CLSID key. setKeyAndValue(szKey, _T("InprocServer32"), szModule) ; // set the threading model _tcscat(szKey, _T("\\InprocServer32")); setValue(szKey, _T("ThreadingModel"), _T("Apartment")); // Free memory. CoTaskMemFree(wszCLSID) ; return S_OK ; } // // Remove the component from the registry. // LONG UnregisterServer(const CLSID& clsid) // IDs { // Get CLSID LPOLESTR wszCLSID = NULL ; HRESULT hr = StringFromCLSID(clsid, &wszCLSID) ; // Build the key CLSID\\{...} _TCHAR szKey[64] ; _tcscpy(szKey, _T("CLSID\\")) ; MAKE_TSTRPTR_FROMWIDE(pszT, wszCLSID); _tcscat(szKey, pszT) ; // Delete the CLSID Key - CLSID\{...} LONG lResult = recursiveDeleteKey(HKEY_CLASSES_ROOT, szKey) ; assert((lResult == ERROR_SUCCESS) || (lResult == ERROR_FILE_NOT_FOUND)) ; // Subkey may not exist. // Free memory. CoTaskMemFree(wszCLSID) ; return S_OK ; } // // Register the snap-in in the registry. // HRESULT RegisterSnapin(const CLSID& clsid, // Class ID const _TCHAR* szNameString, // NameString const CLSID& clsidAbout, // Class Id for About Class const BOOL fSupportExtensions) { // Get CLSID LPOLESTR wszCLSID = NULL ; LPOLESTR wszAboutCLSID = NULL; HRESULT hr = StringFromCLSID(clsid, &wszCLSID) ; MAKE_TSTRPTR_FROMWIDE(pszCLSID, wszCLSID); // Add the CLSID to the registry. setSnapInKeyAndValue(pszCLSID, NULL, _T("NameString"), szNameString) ; setSnapInKeyAndValue(pszCLSID, _T("StandAlone"), NULL, NULL); if (IID_NULL != clsidAbout) { hr = StringFromCLSID(clsidAbout, &wszAboutCLSID); MAKE_TSTRPTR_FROMWIDE(pszAboutCLSID, wszAboutCLSID); setSnapInKeyAndValue(pszCLSID, NULL, _T("About"), pszAboutCLSID); } if (fSupportExtensions) { // Build the key NodeType setSnapInKeyAndValue(pszCLSID, _T("NodeTypes"), NULL, NULL); _TCHAR szKey[64] ; _tcscpy(szKey, pszCLSID) ; _tcscat(szKey, _T("\\NodeTypes")) ; setSnapInKeyAndValue(szKey, pszCLSID, NULL, NULL); } // Free memory. CoTaskMemFree(wszCLSID) ; if (IID_NULL != clsidAbout) CoTaskMemFree(wszAboutCLSID); return S_OK ; } // // Unregister the snap-in in the registry. // HRESULT UnregisterSnapin(const CLSID& clsid) // Class ID { _TCHAR szKeyBuf[1024]; LPOLESTR wszCLSID = NULL; // Get CLSID HRESULT hr = StringFromCLSID(clsid, &wszCLSID); MAKE_TSTRPTR_FROMWIDE(pszCLSID, wszCLSID); // Load the buffer with the Snap-In Location _tcscpy(szKeyBuf, _T("SOFTWARE\\Microsoft\\MMC\\SnapIns")); // Copy keyname into buffer. _tcscat(szKeyBuf, _T("\\")); _tcscat(szKeyBuf, pszCLSID); // Delete the CLSID Key - CLSID\{...} LONG lResult = recursiveDeleteKey(HKEY_LOCAL_MACHINE, szKeyBuf); assert((lResult == ERROR_SUCCESS) || (lResult == ERROR_FILE_NOT_FOUND)) ; // Subkey may not exist. // free the memory CoTaskMemFree(wszCLSID); return S_OK; } // // Delete a key and all of its descendents. // LONG recursiveDeleteKey(HKEY hKeyParent, // Parent of key to delete const _TCHAR* lpszKeyChild) // Key to delete { // Open the child. HKEY hKeyChild ; LONG lRes = RegOpenKeyEx(hKeyParent, lpszKeyChild, 0, KEY_ALL_ACCESS, &hKeyChild) ; if (lRes != ERROR_SUCCESS) { return lRes ; } // Enumerate all of the decendents of this child. FILETIME time ; _TCHAR szBuffer[256] ; DWORD dwSize = 256 ; while (RegEnumKeyEx(hKeyChild, 0, szBuffer, &dwSize, NULL, NULL, NULL, &time) == S_OK) { // Delete the decendents of this child. lRes = recursiveDeleteKey(hKeyChild, szBuffer) ; if (lRes != ERROR_SUCCESS) { // Cleanup before exiting. RegCloseKey(hKeyChild) ; return lRes; } dwSize = 256 ; } // Close the child. RegCloseKey(hKeyChild) ; // Delete this child. return RegDeleteKey(hKeyParent, lpszKeyChild) ; } // // Create a key and set its value. // - This helper function was borrowed and modifed from // Kraig Brockschmidt's book Inside OLE. // BOOL setKeyAndValue(const _TCHAR* szKey, const _TCHAR* szSubkey, const _TCHAR* szValue) { HKEY hKey; _TCHAR szKeyBuf[1024] ; // Copy keyname into buffer. _tcscpy(szKeyBuf, szKey) ; // Add subkey name to buffer. if (szSubkey != NULL) { _tcscat(szKeyBuf, _T("\\")) ; _tcscat(szKeyBuf, szSubkey ) ; } // Create and open key and subkey. long lResult = RegCreateKeyEx(HKEY_CLASSES_ROOT , szKeyBuf, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_ALL_ACCESS, NULL, &hKey, NULL) ; if (lResult != ERROR_SUCCESS) { return FALSE ; } // Set the Value. if (szValue != NULL) { RegSetValueEx(hKey, NULL, 0, REG_SZ, (BYTE *)szValue, (_tcslen(szValue)+1)*sizeof(_TCHAR)) ; } RegCloseKey(hKey) ; return TRUE ; } // // Open a key value and set it // BOOL setValue(const _TCHAR* szKey, const _TCHAR* szValueName, const _TCHAR* szValue) { HKEY hKey; _TCHAR szKeyBuf[1024] ; // Copy keyname into buffer. _tcscpy(szKeyBuf, szKey) ; // Create and open key and subkey. long lResult = RegCreateKeyEx(HKEY_CLASSES_ROOT , szKeyBuf, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_ALL_ACCESS, NULL, &hKey, NULL) ; if (lResult != ERROR_SUCCESS) { return FALSE ; } // Set the Value. if (szValue != NULL) { RegSetValueEx(hKey, szValueName, 0, REG_SZ, (BYTE *)szValue, (_tcslen(szValue)+1)*sizeof(_TCHAR)) ; } RegCloseKey(hKey) ; return TRUE ; } // // Create a key and set its value. // - This helper function was borrowed and modifed from // Kraig Brockschmidt's book Inside OLE. // BOOL setSnapInKeyAndValue(const _TCHAR* szKey, const _TCHAR* szSubkey, const _TCHAR* szName, const _TCHAR* szValue) { HKEY hKey; _TCHAR szKeyBuf[1024] ; // Load the buffer with the Snap-In Location _tcscpy(szKeyBuf, _T("SOFTWARE\\Microsoft\\MMC\\SnapIns")); // Copy keyname into buffer. _tcscat(szKeyBuf, _T("\\")) ; _tcscat(szKeyBuf, szKey) ; // Add subkey name to buffer. if (szSubkey != NULL) { _tcscat(szKeyBuf, _T("\\")) ; _tcscat(szKeyBuf, szSubkey ) ; } // Create and open key and subkey. long lResult = RegCreateKeyEx(HKEY_LOCAL_MACHINE , szKeyBuf, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_ALL_ACCESS, NULL, &hKey, NULL) ; if (lResult != ERROR_SUCCESS) { return FALSE ; } // Set the Value. if (szValue != NULL) { RegSetValueEx(hKey, szName, 0, REG_SZ, (BYTE *)szValue, (_tcslen(szValue)+1)*sizeof(_TCHAR)) ; } RegCloseKey(hKey) ; return TRUE ; }