IX509PrivateKey::Export, méthode (certenroll.h)
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 |
|---|---|
|
Exporte uniquement la partie publique de la clé privée. |
|
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 |
|---|---|
|
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 |