Metodo IEnroll4::createFileRequestWStr (xenroll.h)

  • Articolo

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

Il metodo createFileRequestWStr crea una richiesta di certificato di formato PKCS #10, PKCS #7 o gestione completa dei certificati tramite CMS (CMC) e la archivia in un file. Questo metodo è stato definito per la prima volta nell'interfaccia IEnroll4 .

Sintassi

HRESULT createFileRequestWStr(
  [in] LONG    Flags,
  [in] LPCWSTR pwszDNName,
  [in] LPCWSTR pwszUsage,
  [in] LPCWSTR pwszRequestFileName
);

Parametri

[in] Flags

Valore che specifica il tipo di richiesta di certificato da creare. Specificare 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] pwszDNName

Puntatore a una stringa di caratteri wide con terminazione Null che rappresenta 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 non esiste un prefisso di due lettere, è possibile specificare invece un identificatore di oggetto (OID). Questo parametro può essere NULL.

[in] pwszUsage

Puntatore a una stringa di caratteri wide con terminazione Null per l'OID che descrive lo scopo del certificato generato, ad esempio il certificato Authenticode singolo o commerciale o l'autenticazione client. È anche possibile specificare più URI separati da una virgola.

[in] pwszRequestFileName

Puntatore a una stringa di caratteri wide con terminazione Null contenente il nome del file che riceverà la richiesta.

Valore restituito

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 dei codici di errore comuni, vedere Valori HRESULT comuni.

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

Vedi anche

IEnroll4