Fonction RKeyPFXInstall

  • Article

La fonction RKeyPFXInstall n’est pas prise en charge.

Windows Server 2003 : La fonction RKeyPFXInstall installe un certificat sur un ordinateur distant. Notez que ce comportement a changé avec Windows Server 2003 avec Service Pack 1 (SP1).

Syntaxe

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

Paramètres

hKeySvcCli [in]

Un handle KEYSVCC_HANDLE précédemment ouvert par RKeyOpenKeyService. Le handle représente l’ordinateur distant qui recevra le certificat. Cette valeur ne peut pas être NULL.

pPFX [in]

Pointeur vers une structure KEYSVC_BLOB qui représente le certificat à installer. L’objet BLOB est au format PKCS #12 .

pPassword [in]

Pointeur vers une structure KEYSVC_UNICODE_STRING qui représente le mot de passe de l’objet BLOB. Lorsque vous avez terminé d’utiliser le mot de passe, effacez le mot de passe de la mémoire en appelant la fonction SecureZeroMemory . Pour plus d’informations sur la protection des mots de passe, consultez Gestion des mots de passe.

ulFlags [in]

Indicateurs qui spécifient les options d’installation de certificat. Ce paramètre peut être un zéro ou une combinaison des valeurs suivantes.

Valeur Signification
CRYPT_EXPORTABLE
 Les clés importées sont marquées comme étant exportables.
CRYPT_MACHINE_KEYSET
 Les clés privées sont stockées sous l’ordinateur distant et non sous l’utilisateur actuel.

 

Valeur retournée

Si la fonction réussit, la valeur de retour est S_OK.

Si la fonction échoue, la valeur de retour est un ULONG qui indique l’erreur.

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Aucun pris en charge
Serveur minimal pris en charge
 Windows Server 2003 [applications de bureau uniquement]
En-tête
Rkeysvcc.h

Voir aussi

RKeyCloseKeyService

RKeyOpenKeyService