RKeyOpenKeyService function

The RKeyOpenKeyService function is not supported.

Windows Server 2003: The RKeyOpenKeyService function establishes a connection to a remote computer and opens a key service handle. The key service handle can subsequently be used by the RKeyPFXInstall function. Note that this behavior has changed with Windows Server 2003 with Service Pack 1 (SP1).

Syntax

ULONG RKeyOpenKeyService(
  _In_    LPSTR          pszMachineName,
  _In_    KEYSVC_TYPE    OwnerType,
  _In_    LPWSTR         pwszOwnerName,
  _In_    void           *pAuthentication,
  _Inout_ void           *pReserved,
  _Out_   KEYSVCC_HANDLE *phKeySvcCli
);

Parameters

pszMachineName [in]

Long pointer to a null-terminated string that represents the computer where the key service handle will be opened.

OwnerType [in]

KEYSVC_TYPE value that represents the key type. The only supported value is KeySvcMachine.

pwszOwnerName [in]

Reserved. Set this value to NULL.

pAuthentication [in]

A pointer to a void that represents the authentication settings. This pointer can point to a value of zero or the following value.

Value Meaning
RKEYSVC_CONNECT_SECURE_ONLY
The client requires mutual authentication. If this value is specified, fallback to NTLM will fail.

 

pReserved [in, out]

Reserved. Set this value to NULL.

phKeySvcCli [out]

A pointer to a KEYSVCC_HANDLE that receives the opened key service handle. When you have finished using the handle, free the resource by calling the RKeyCloseKeyService function.

Return value

If the function is successful, the return value is S_OK.

If the function fails, the return value is a ULONG that indicates the error.

Requirements

Requirement Value
Minimum supported client
None supported
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Rkeysvcc.h

See also

RKeyCloseKeyService

RKeyPFXInstall