Método ICertRequest3::GetIssuedCertificate2 (certcli.h)

Artículo
08/22/2023

El método GetIssuedCertificate2 recupera la disposición de un certificado especificando la cadena de identificador de solicitud o el número de serie del certificado.

Sintaxis

HRESULT GetIssuedCertificate2(
  [in]          BSTR strConfig,
  [in]          BSTR strRequestId,
  [in]          BSTR strSerialNumber,
  [out, retval] LONG *pDisposition
);

Parámetros

[in] strConfig

Representa una cadena de configuración válida para el servidor de Servicios de certificados . La cadena puede ser una dirección URL HTTPS para un servidor de inscripción o con el formato NombreDeEquipoDeEquipo\, dondeNombreDeEquipo es el nombre de red del servidor y CAName es el nombre común de la entidad de certificación, tal como se especifica durante la instalación de Servicios de certificados. Para obtener información sobre el nombre de la cadena de configuración, vea ICertConfig.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: No se admite una dirección URL HTTPS como entrada.

[in] strRequestId

Valor BSTR que representa el identificador de solicitud de certificado en la base de datos de Servicios de certificados. Establezca este parámetro en NULL si el número de serie (pasado como strSerialNumber) se usará en lugar del identificador de solicitud.

Use el método ICertRequest3::GetRequestIdString para obtener la cadena de identificador de solicitud.

[in] strSerialNumber

Valor BSTR que representa el número de serie del certificado, según lo emitido por la ENTIDAD de certificación. La cadena debe especificar el número de serie como un número par de dígitos hexadecimales. Si es necesario, se puede prefijar un cero al número para generar un número par de dígitos. Sin embargo, no se puede usar más de un cero inicial.

El valor strSerialNumber solo se usa cuando strRequestId se establece en NULL.

[out, retval] pDisposition

Puntero a un valor LONG que representa la disposición del certificado. La disposición es uno de los valores siguientes.

Valor	Significado
CR_DISP_DENIED	Solicitud denegada.
CR_DISP_ERROR	Error en la solicitud.
CR_DISP_INCOMPLETE	La solicitud no se completó.
CR_DISP_ISSUED	Certificado emitido.
CR_DISP_ISSUED_OUT_OF_BAND	Certificado emitido por separado.
CR_DISP_UNDER_SUBMISSION	Solicitud realizada en el envío.

Valor devuelto

C++

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.

VB

El valor devuelto es un long que representa la disposición del certificado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certcli.h (incluya Certsrv.h)
Library	Certidl.lib
Archivo DLL	Certcli.dll

Consulte también

CCertRequest

ICertRequest3