Metodo ICEnroll4::createFileRequest (xenroll.h)

  • Articolo

[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