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 |
|
See also