Metodo IEnroll::acceptPKCS7Blob (xenroll.h)
[Questo metodo non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]
Il metodo acceptPKCS7Blob accetta ed elabora un messaggio PKCS #7 contenente un certificato. PKCS #7 è input come parametro. Questo metodo è stato definito per la prima volta nell'interfaccia IEnroll .
Sintassi
HRESULT acceptPKCS7Blob(
[in] PCRYPT_DATA_BLOB pBlobPKCS7
);
Parametri
[in] pBlobPKCS7
Rappresenta l'pkCS #7 con codifica base64 contenente il certificato e la catena di certificati che identificano l'autorità emittente.
Valore restituito
Il valore restituito è HRESULT. Il valore S_OK indica l'esito positivo. Al termine di questa funzione, pkCS #7 verrà accettato.
Commenti
L'input PKCS #7 come parametro per acceptPKCS7Blob contiene il certificato di richiesta e la catena di certificati che identificano l'autorità emittente del certificato. In genere, ma non sempre, la catena di certificati non include la radice. PKCS #7 può essere in formato certificato con codifica Base64, binario o X.509 (con o senza i tag "begin cert" e "end cert"). Il certificato e le chiavi associate generate per questo vengono inseriti nell'archivio MY. Un certificato radice viene inserito nell'archivio ROOT e il resto della catena di certificati viene inserito nell'archivio dell'autorità di certificazione (CA). Se vengono accettati certificati ROOT trovati in PKCS #7, Crypt32 informerà l'utente che viene aggiunto un certificato ROOT all'archivio dell'utente. L'utente ha la possibilità di rifiutare il certificato ROOT. Questa opzione viene fornita in modo che l'utente possa rifiutare di inserire una radice non attendibile nell'archivio ROOT. Se si rifiuta di inserire ROOT nell'archivio ROOT, il controllo di registrazione certificati non avrà esito negativo.
Per impostazione predefinita, gli archivi di sistema MY, CA, ROOT e REQUEST vengono usati per archiviare i certificati. È tuttavia possibile specificare altri archivi assegnando le proprietà seguenti prima di chiamare questo metodo:
Requisiti
Client minimo supportato | Windows XP [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | xenroll.h |
Libreria | Uuid.lib |
DLL | Xenroll.dll |