15 сент. 2010 г.

RegConnectRegistry


Функция RegConnectRegistry устанавливает соединение к предопределенному дескриптору реестра на другом компьютере.
LONG RegConnectRegistry(
    LPTSTR lpMachineName, // адрес имени удаленного компьютера 
    HKEY hKey,  // предопределенный дескриптор реестра 
    PHKEY phkResult  // адрес буфера для дескриптора удаленного реестра 
   );
Параметры:
lpMachineNameАдрес нульзаканчивающейся строки, содержащей имя удаленного компьютера. Строка имеет следующую форму:
\\computername
Если lpMachineName равно NULL, то используется имя локального компьютера.
hKeyИдентифицирует открытый ключ для закрытия.
phkResultОпределяет предопределенный дескриптор реестра на удаленном компьютере. Могут быть использованы только следующие значения:

HKEY_LOCAL_MACHINE
HKEY_USERS

Приложения не могут использовать значения HKEY_CLASSES_ROOT или HKEY_CURRENT_USER в этом параметре.

Возвращаемые значения:
Если функция успешна, возвращается значение ERROR_SUCCESS.

При ошибке, возвращаемое значение – это код ошибки, объявленный в WINERROR.H. Вы можете использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM для получения общего описания ошибки.
Замечания:
Когда дескриптор, возвращенный RegConnectRegistry, больше не нужен, его нужно закрыть вызовом RegCloseKey.
Смотрите также: