Partager via

IX509PrivateKey::Export, méthode (certenroll.h)

  • Article

La méthode Export copie la clé privée dans un tableau d’octets. Le tableau d’octets est représenté par une chaîne encodée unicode.

Syntaxe

HRESULT Export(
  [in]  BSTR         strExportType,
  [in]  EncodingType Encoding,
  [out] BSTR         *pstrEncodedKey
);

Paramètres

[in] strExportType

Valeur BSTR qui spécifie comment la clé privée est exportée.

Si la clé a été créée à l’aide d’un fournisseur de stockage de clés (KSP) CNG, vous pouvez spécifier l’une des valeurs autorisées par le paramètre pszBlobType dans la fonction NCryptExportKey .

Si la clé a été créée à l’aide d’un fournisseur de services de chiffrement CryptoAPI, vous pouvez spécifier l’une des valeurs suivantes à partir du fichier d’en-tête Bcrypt.h inclus avec Wincrypt.h.

Valeur Signification
BCRYPT_PUBLIC_KEY_BLOB
 Exporte uniquement la partie publique de la clé privée.
BCRYPT_PRIVATE_KEY_BLOB
 Exporte la clé privée entière.

[in] Encoding

Valeur d’énumération EncodingType qui spécifie le type d’encodage Unicode à appliquer à la chaîne contenue dans le paramètre pstrEncodedKey . La valeur par défaut est XCN_CRYPT_STRING_BASE64.

[out] pstrEncodedKey

Pointeur vers une variable BSTR qui contient la clé privée.

Valeur retournée

Si la fonction réussit, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles sont notamment celles figurant dans le tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Code de retour Description
HRESULT_FROM_WIN32(ERROR_CALL_NOT_IMPLEMENTED)
 La clé a été créée par un csp CryptoAPI et vous avez spécifié une valeur autre que BCRYPT_PRIVATE_KEY_BLOB ou BCRYPT_PUBLIC_KEY_BLOB pour le paramètre strExportType .

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête certenroll.h
DLL CertEnroll.dll

Voir aussi

IX509PrivateKey