Export (0) Print
Expand All
Expand Minimize

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.

ValueMeaning
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

Minimum supported client

None supported

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Rkeysvcc.h

See also

RKeyCloseKeyService
RKeyPFXInstall

 

 

Community Additions

ADD
Show:
© 2014 Microsoft