Metodo ICEnroll4::createFileRequest (xenroll.h)

Articolo
03/04/2024

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

Il metodo createFileRequest crea una richiesta di certificato PKCS #10, una richiesta PKCS #7 o una richiesta di Gestione certificati completa su CMS (CMC) e la archivia in un file. Questo metodo è stato definito per la prima volta nell'interfaccia ICEnroll4 .

Sintassi

HRESULT createFileRequest(
  [in] LONG Flags,
  [in] BSTR strDNName,
  [in] BSTR strUsage,
  [in] BSTR strRequestFileName
);

Parametri

[in] Flags

Valore che specifica il tipo di certificato da creare. Questo può essere uno dei valori seguenti.

Valore	Significato
XECR_CMC	CmC completo
XECR_PKCS10_V1_5	PKCS 10
XECR_PKCS10_V2_0	PKCS 10 versione 2
XECR_PKCS7	PKCS 7

[in] strDNName

Questo parametro può essere NULL; in caso contrario, questo parametro specifica il nome distinto (DN) dell'entità per cui viene effettuata la richiesta. Il nome DN deve seguire la convenzione di denominazione X.500 , ad esempio "CN=User, O=Microsoft". Se invece non esiste un prefisso a due lettere, è possibile specificare un OID.

[in] strUsage

Identificatore di oggetto (OID) che descrive lo scopo della richiesta generata, ad esempio un certificato Authenticode singolo o commerciale o l'autenticazione client. È anche possibile specificare più ID separati da una virgola.

[in] strRequestFileName

Nome del file che riceverà la richiesta.

Valore restituito

VB

Se il metodo ha esito positivo, il metodo restituisce S_OK.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Quando questo metodo viene chiamato dallo script, il metodo visualizza un'interfaccia utente che chiede se l'utente consentirà la creazione di una richiesta di certificato e se l'utente consentirà un'operazione di scrittura al file system.

Requisiti

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

Condividi tramite