Share via

Metodo IX509PrivateKey::Export (certenroll.h)

  • Articolo

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
BCRYPT_PUBLIC_KEY_BLOB
 Esporta solo la parte pubblica della chiave privata.
BCRYPT_PRIVATE_KEY_BLOB
 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
HRESULT_FROM_WIN32(ERROR_CALL_NOT_IMPLEMENTED)
 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

Vedi anche

IX509PrivateKey