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

Artigo
02/23/2024

O método GetInnerRequest recupera um objeto de solicitação aninhado.

Sintaxe

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

Parâmetros

[in] Level

Um valor de uma enumeração InnerRequestLevel que especifica o nível de envelopment dos dados a serem recuperados. Você pode usar o valor LevelNext para iterar por meio dos níveis aninhados ou do valor LevelInnermost para recuperar o objeto de solicitação mais profundamente aninhado. Não é possível especificar LevelNext para uma solicitação PKCS nº 10.

[out] ppValue

Endereço de uma variável que recebe um ponteiro para uma interface IX509CertificateRequest que contém a solicitação aninhada. Chame a propriedade Type para determinar se o objeto de solicitação interna é um PKCS #10 ou uma solicitação CMC. Em seguida, chame QueryInterface para recuperar o ponteiro apropriado.

Retornar valor

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Valor/código retornado	Descrição
CERTSRV_E_PROPERTY_EMPTY	Você especificou um valor da solicitação LevelNext PKCS #10.

Comentários

Um objeto de solicitação de nível superior pode ser uma solicitação PKCS nº 10, PKCS nº 7 ou CMC. As seguintes regras se aplicam a objetos de solicitação interna:

Uma solicitação PKCS nº 10 não pode conter um objeto de solicitação interna.
Uma solicitação PKCS nº 7 pode conter apenas um objeto de solicitação interna PKCS nº 10.
Uma solicitação CMC pode conter um objeto de solicitação interna CMC ou PKCS nº 10. Para uma solicitação CMC que contém uma solicitação CMC interna, não há nenhum limite teórico para o número de níveis aninhados que podem existir antes que a solicitação PKCS nº 10 interna final seja atingida. Ou seja, uma solicitação CMC de nível superior pode conter uma solicitação CMC interna que também contém uma solicitação CMC interna e assim por diante.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certenroll.h
DLL	CertEnroll.dll