Método IX509CertificateRequest::GetInnerRequest (certenroll.h)

Artículo
02/26/2024

El método GetInnerRequest recupera un objeto de solicitud anidado.

Sintaxis

HRESULT GetInnerRequest(
  [in]  InnerRequestLevel       Level,
  [out] IX509CertificateRequest **ppValue
);

Parámetros

[in] Level

Valor de una enumeración InnerRequestLevel que especifica el nivel de instrucciones de los datos que se van a recuperar. Puede usar el valor LevelNext para recorrer en iteración los niveles anidados o el valor LevelInnermost para recuperar el objeto de solicitud más profundamente anidado. No se puede especificar LevelNext para una solicitud PKCS #10.

[out] ppValue

Dirección de una variable que recibe un puntero a una interfaz IX509CertificateRequest que contiene la solicitud anidada. Llame a la propiedad Type para determinar si el objeto de solicitud interno es un PKCS #10 o una solicitud CMC. A continuación, llame a QueryInterface para recuperar el puntero adecuado.

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código o valor devuelto	Descripción
CERTSRV_E_PROPERTY_EMPTY	Especificó un valor de la solicitud PKCS #10 LevelNext .

Comentarios

Un objeto de solicitud de nivel superior puede ser una solicitud PKCS #10, PKCS #7 o CMC. Las reglas siguientes se aplican a los objetos de solicitud internos:

Una solicitud PKCS #10 no puede contener un objeto de solicitud interno.
Una solicitud PKCS #7 solo puede contener un objeto de solicitud interno PKCS #10.
Una solicitud de CMC puede contener un CMC o un objeto de solicitud interno PKCS #10. Para una solicitud de CMC que contiene una solicitud de CMC interna, no hay ningún límite teórico para el número de niveles anidados que pueden existir antes de que se alcance la solicitud PKCS #10 interna final. Es decir, una solicitud de CMC de nivel superior puede contener una solicitud de CMC interna que también contiene una solicitud de CMC interna, etc.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certenroll.h
Archivo DLL	CertEnroll.dll