RKeyPFXInstall function

The RKeyPFXInstall function is not supported.

Windows Server 2003: The RKeyPFXInstall function installs a certificate on a remote computer. Note that this behavior has changed with Windows Server 2003 with Service Pack 1 (SP1).

Syntax

ULONG RKeyPFXInstall(
  _In_ KEYSVCC_HANDLE         hKeySvcCli,
  _In_ PKEYSVC_BLOB           pPFX,
  _In_ PKEYSVC_UNICODE_STRING pPassword,
  _In_ ULONG                  ulFlags
);

Parameters

hKeySvcCli [in]

A KEYSVCC_HANDLE handle previously opened by RKeyOpenKeyService. The handle represents the remote computer that will receive the certificate. This value cannot be NULL.

pPFX [in]

A pointer to a KEYSVC_BLOB structure that represents the certificate to install. The BLOB is in PKCS #12 format.

pPassword [in]

A pointer to a KEYSVC_UNICODE_STRING structure that represents the password for the BLOB. When you have finished using the password, clear the password from memory by calling the SecureZeroMemory function. For more information about protecting passwords, see Handling Passwords.

ulFlags [in]

Flags that specify the certificate installation options. This parameter can be a zero or a combination of the following values.

Value Meaning
CRYPT_EXPORTABLE
Imported keys are marked as exportable.
CRYPT_MACHINE_KEYSET
Private keys are stored under the remote computer and not under the current user.

 

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

RKeyOpenKeyService