Metodo IEnroll4::createFileRequestWStr (xenroll.h)
[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 |
---|---|
|
CMC completo |
|
PKCS #10 |
|
PKCS #10 versione 2 |
|
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 |