Metodo IEnroll4::createRequestWStr (xenroll.h)

  • Articolo

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

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

Sintassi

HRESULT createRequestWStr(
  [in]  LONG             Flags,
  [in]  LPCWSTR          pwszDNName,
  [in]  LPCWSTR          pwszUsage,
  [out] PCRYPT_DATA_BLOB pblobRequest
);

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 Unicode con terminazione Null che contiene 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 Unicode con terminazione Null contenente l'OID che descrive lo scopo del certificato generato, ad esempio certificato Authenticode singolo o commerciale o autenticazione client. È anche possibile specificare più URI separati da una virgola.

[out] pblobRequest

Puntatore a una struttura CRYPT_DATA_BLOB che riceve la richiesta.

Al termine dell'uso di questa memoria, liberarlo passando il membro pbData di questa struttura alla funzione CoTaskMemFree .

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

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

Vedi anche

IEnroll4