Establishes a connection to a predefined registry handle on another computer.

When you no longer need a handle returned by this call, you should close it by calling RegCloseKey.

LONG RegConnectRegistry(
    LPTSTR lpMachineName,
    HKEY hKey,
    PHKEY phkResult
);

Parameters

lpMachineName

Pointer to a null-terminated string that contains the remote computer's name. The string has this form:

\\computername

If lpMachineName is NULL, the local Windows host computer name is used.

hKey

Specifies the one of these predefined registry handles on the remote computer:

HKEY_LOCAL_MACHINE HKEY_USERS HKEY_PERFORMANCE_DATA

You cannot specify the HKEY_CLASSES_ROOT or HKEY_CURRENT_USER value for this parameter.

phkResult

Pointer to a variable that receives a key handle identifying the predefined handle on the remote computer.

Remarks

You cannot specify the value HKEY_CLASSES_ROOT or HKEY_CURRENT_USER for hKey.

Return Values

ERROR_SUCCESS

Success.

A nonzero status code defined in RTWIN32.H.

Failure. For extended error information, see GetLastError.

Requirements

Note

This function operates in the real-time portion of your application.

See Also

RegCloseKey, iwin32 API, iwin32 Overview