Metodo IX509PrivateKey::Import (certenroll.h)

  • Articolo

Il metodo Import importa una chiave privata esistente in un contenitore di chiavi all'interno di un provider di crittografia.

Sintassi

HRESULT Import(
  [in] BSTR         strExportType,
  [in] BSTR         strEncodedKey,
  [in] EncodingType Encoding
);

Parametri

[in] strExportType

Se la chiave è stata creata usando un provider di archiviazione chiavi CNG, il metodo Import passa questo argomento al parametro pszProperty della funzione NCryptSetProperty . Ovvero, il valore specificato verrà usato come nome di una proprietà da impostare sulla chiave importata.

Se la chiave è stata creata usando un CSP CryptoAPI (Cryptographic Service Provider), questo argomento specifica come importare la chiave privata. Può trattarsi del valore seguente.

Valore Significato
BCRYPT_PRIVATE_KEY_BLOB
 Importa l'intera chiave privata.

[in] strEncodedKey

Variabile BSTR che contiene la chiave da importare.

[in] Encoding

Valore di enumerazione EncodingType che specifica il tipo di codifica Unicode da applicare alla stringa contenuta nel parametro strEncodedKey . Il valore predefinito è XCN_CRYPT_STRING_BASE64.

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 dei codici di errore comuni, vedere Valori HRESULT comuni.

Codice restituito Descrizione
HRESULT_FROM_WIN32(ERROR_FILE_READ_ONLY)
 Il contenitore di chiavi è già aperto. È possibile ricevere questo errore se è già stato chiamato Open o Create.
HRESULT_FROM_WIN32(ERROR_CALL_NOT_IMPLEMENTED)
 La chiave è stata creata da un CSP CryptoAPI ed è stato specificato un valore diverso da BCRYPT_PRIVATE_KEY_BLOB per il parametro strExportType .

Commenti

La funzione Import presuppone automaticamente che si stia tentando di importare una chiave KSP CNG se si specifica un valore diverso da BCRYPT_PRIVATE_KEY_BLOB per il parametro strExportType e non si imposta alcuna delle proprietà seguenti:

Requisiti

Requisito Valore
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