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