RegConnectRegistry
The RegConnectRegistry
function establishes a connection to a predefined registry handle on another
computer.
LONG RegConnectRegistry(
|
LPTSTR lpMachineName, |
// address of name
of remote computer |
|
HKEY hKey, |
// predefined
registry handle |
|
PHKEY phkResult |
// address of
buffer for remote registry handle |
|
); |
|
Parameters
lpMachineName
Points to a
null-terminated string containing the name of the remote computer. The string
has the following form:
\\computername
If lpMachineName is NULL, the local computer name is used.
hKey
Specifies the
predefined handle of the registry on the remote computer. Currently, the
following values can be used:
HKEY_LOCAL_MACHINE
HKEY_USERS
An application cannot specify the HKEY_CLASSES_ROOT or HKEY_CURRENT_USER
value for this parameter.
phkResult
Points to a
variable that receives a key handle identifying the predefined handle on the
remote computer.
Return Values
If the
function succeeds, the return value is ERROR_SUCCESS.
If the
function fails, the return value is a nonzero error code defined in WINERROR.H.
You can use the FormatMessage
function with the FORMAT_MESSAGE_FROM_SYSTEM flag to get a generic description
of the error.
Remarks
When a handle
returned by RegConnectRegistry is no longer needed, it should be closed
by calling RegCloseKey.
See Also