Método IEnroll4::createRequestWStr (xenroll.h)

  • Artículo

[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
XECR_CMC
 CMC completo
XECR_PKCS10_V1_5
 PKCS #10
XECR_PKCS10_V2_0
 PKCS #10 versión 2
XECR_PKCS7
 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

Consulte también

IEnroll4