Metodo ICEnroll::acceptPKCS7 (xenroll.h)

Articolo
08/28/2023

[Questo metodo non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

Il metodo acceptPKCS7 accetta e elabora un messaggio PKCS #7 che contiene un certificato. PKCS #7 è input come parametro. Questo metodo è stato definito per la prima volta nell'interfaccia ICEnroll .

Sintassi

HRESULT acceptPKCS7(
  [in] BSTR PKCS7
);

Parametri

[in] PKCS7

Rappresenta la chiave PKCS #7 con codifica base64 che contiene il certificato e la catena di certificati che identifica l'autorità emittente.

Valore restituito

VB

Il valore restituito è un HRESULT. Un valore di S_OK indica l'esito positivo. Al termine di questa funzione, verrà accettato PKCS #7.

Commenti

L'input PKCS #7 come parametro per acceptPKCS7 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. Il formato certificato PKCS #7 può essere con codifica base64, binario o X.509 (con o senza i tag del certificato di inizio/fine). Il certificato e le chiavi associate generate vengono inserite 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 i certificati ROOT presenti in PKCS #7, Crypt32 notifica all'utente che viene aggiunto un certificato ROOT al suo archivio. L'utente ha l'opzione 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 posizionare root nell'archivio ROOT, il controllo registrazione certificati non avrà esito negativo.

Per impostazione predefinita, il sistema archivia MY, CA, ROOT e REQUEST per archiviare i certificati. È tuttavia possibile specificare altri archivi assegnando le proprietà seguenti prima di chiamare questo metodo:

Quando questo metodo viene chiamato dallo script, il metodo visualizza un'interfaccia utente che chiede se l'utente consentirà l'installazione di un certificato.

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