Método IEnroll4::createRequestWStr (xenroll.h)
[Este método ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]
El método createRequestWStr crea una solicitud de certificado de formato PKCS #10, PKCS #7 o administración completa de certificados a través de CMS (CMC) y la almacena en un BLOB. Este método se definió por primera vez en la interfaz IEnroll4 .
Sintaxis
HRESULT createRequestWStr(
[in] LONG Flags,
[in] LPCWSTR pwszDNName,
[in] LPCWSTR pwszUsage,
[out] PCRYPT_DATA_BLOB pblobRequest
);
Parámetros
[in] Flags
Valor que especifica el tipo de solicitud de certificado que se va a crear. Especifique uno de los valores siguientes.
Valor | Significado |
---|---|
|
CMC completo |
|
PKCS #10 |
|
PKCS #10 versión 2 |
|
PKCS #7 |
[in] pwszDNName
Puntero a una cadena Unicode terminada en null que contiene el nombre distintivo (DN) de la entidad para la que se realiza la solicitud. El nombre de DN debe seguir la convención de nomenclatura X.500 , por ejemplo"CN=User, O=Microsoft". Si no existe un prefijo de dos letras, se puede proporcionar un identificador de objeto (OID) en su lugar. Este parámetro puede ser NULL.
[in] pwszUsage
Puntero a una cadena Unicode terminada en null que contiene el OID que describe el propósito del certificado que se genera, por ejemplo, certificado Authenticode individual o comercial, o autenticación de cliente. También puede especificar varios OID separados por una coma.
[out] pblobRequest
Puntero a una estructura CRYPT_DATA_BLOB que recibe la solicitud.
Cuando haya terminado de usar esta memoria, libere esta memoria pasando el miembro pbData de esta estructura a la función CoTaskMemFree .
Valor devuelto
Si el método se realiza correctamente, el método devuelve S_OK.
Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
Plataforma de destino | Windows |
Encabezado | xenroll.h |
Library | Uuid.lib |
Archivo DLL | Xenroll.dll |