Compartir a través de

Método ICertRequest2::GetIssuedCertificate (certcli.h)

  • Artículo

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

Este método es eficazmente el mismo que llamar a ICertRequest3::RetrievePending, con la funcionalidad adicional de especificar un número de serie para el certificado en cuestión.

Sintaxis

HRESULT GetIssuedCertificate(
  [in]          const BSTR strConfig,
  [in]          LONG       RequestId,
  [in]          const 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\, donde NombreDeEquipo 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 configuració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] RequestId

Valor LONG que representa el identificador de solicitud de certificado en la base de datos de Servicios de certificados. Use –1 para este valor si el número de serie (pasado como strSerialNumber) se va a usar en lugar del 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. Para que se use strSerialNumber , debe especificar un valor de –1 para RequestId.

[out, retval] pDisposition

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

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 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 XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certcli.h (incluya Certsrv.h)
Library Certidl.lib
Archivo DLL Certcli.dll