Funzione CryptImportPKCS8 (wincrypt.h)
[La funzione CryptImportPKCS8 non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista. Usare invece la funzione PFXImportCertStore .
Sintassi
BOOL CryptImportPKCS8(
[in] CRYPT_PKCS8_IMPORT_PARAMS sPrivateKeyAndParams,
[in] DWORD dwFlags,
[out, optional] HCRYPTPROV *phCryptProv,
[in, optional] void *pvAuxInfo
);
Parametri
[in] sPrivateKeyAndParams
Struttura CRYPT_PKCS8_IMPORT_PARAMS che contiene il BLOB della chiave privata e i parametri corrispondenti.
[in] dwFlags
Valore DWORD . Questo parametro può essere uno dei valori seguenti, una combinazione di essi o un valore Null.
| Valore | Significato |
|---|---|
|
La chiave importata viene infine riesesportata. Se questo flag non viene usato, le chiamate a CryptExportKey con l'handle di chiave hanno esito negativo. |
|
Se questo flag è impostato, il provider di servizi di configurazione invia una notifica all'utente tramite una finestra di dialogo o un altro metodo quando si tenta di usare questa chiave. Il comportamento preciso viene specificato dal CSP o dal tipo CSP usato. Se il contesto del provider è stato acquisito con CRYPT_SILENT impostato, l'uso di questo flag causa un errore e l'ultimo errore viene impostato su NTE_SILENT_CONTEXT. |
[out, optional] phCryptProv
Puntatore a HCRYPTPROV per ricevere l'handle del provider in cui viene importata la chiave chiamando la funzione CryptImportPKCS8 .
Al termine dell'uso dell'handle, liberare l'handle chiamando CryptReleaseContext.
Questo parametro può essere NULL, nel qual caso l'handle del provider non viene restituito.
[in, optional] pvAuxInfo
Questo parametro deve essere NULL.
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero (TRUE).
Se la funzione non riesce, restituisce zero (FALSE). Per informazioni sugli errori estesi, chiamare GetLastError.
Il codice di errore seguente è specifico di questa funzione.
| Codice restituito | Descrizione |
|---|---|
|
L'identificatore dell'oggetto algoritmo (OID) della chiave privata non è supportato. |
Se la funzione ha esito negativo, GetLastError può restituire un errore di codifica/decodifica ASN.1 ( Abstract Syntax Notation One ). Per informazioni su questi errori, vedere Codifica ASN.1/Decodifica dei valori restituiti.
Commenti
CryptImportPKCS8 chiama la funzione PCRYPT_RESOLVE_HCRYPTPROV_FUNC usando la struttura CRYPT_PKCS8_IMPORT_PARAMS contenuta nel parametro sPrivateKeyAndParams per recuperare un handle del provider in cui importare la chiave. Se PCRYPT_RESOLVE_HCRYPTPROV_FUNC è NULL, viene usato il provider predefinito.
Questa funzione è supportata solo per le chiavi asimmetriche.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wincrypt.h |
| Libreria | Crypt32.lib |
| DLL | Crypt32.dll |