Metodo IEnroll4::createRequestWStr (xenroll.h)

Articolo
03/13/2024

[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

Condividi tramite