Metodo IX509PrivateKey::Export (certenroll.h)
Il metodo Export copia la chiave privata in una matrice di byte. La matrice di byte è rappresentata da una stringa con codifica Unicode.
Sintassi
HRESULT Export(
[in] BSTR strExportType,
[in] EncodingType Encoding,
[out] BSTR *pstrEncodedKey
);
Parametri
[in] strExportType
Valore BSTR che specifica la modalità di esportazione della chiave privata.
Se la chiave è stata creata usando un provider di archiviazione chiavi CNG ,è possibile specificare uno dei valori consentiti dal parametro pszBlobType nella funzione NCryptExportKey .
Se la chiave è stata creata usando un CSP CryptoAPI (provider di servizi crittografici), è possibile specificare uno dei valori seguenti dal file di intestazione Bcrypt.h incluso con Wincrypt.h.
Valore | Significato |
---|---|
|
Esporta solo la parte pubblica della chiave privata. |
|
Esporta l'intera chiave privata. |
[in] Encoding
Valore di enumerazione EncodingType che specifica il tipo di codifica Unicode da applicare alla stringa contenuta nel parametro pstrEncodedKey . Il valore predefinito è XCN_CRYPT_STRING_BASE64.
[out] pstrEncodedKey
Puntatore a una variabile BSTR contenente la chiave privata.
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce S_OK.
Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.
Codice restituito | Descrizione |
---|---|
|
La chiave è stata creata da un CSP CryptoAPI e è stato specificato un valore diverso da BCRYPT_PRIVATE_KEY_BLOB o BCRYPT_PUBLIC_KEY_BLOB per il parametro strExportType . |
Requisiti
Client minimo supportato | Windows Vista [solo app desktop] |
Server minimo supportato | Windows Server 2008 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | certenroll.h |
DLL | CertEnroll.dll |