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

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 desenvolvimento 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. Você não pode 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.

Valor de retorno

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 valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT Comuns.

Observações

Um objeto de solicitação de nível superior pode ser uma solicitação PKCS nº 10, PKCS nº 7 ou CMC. As regras a seguir 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 interna do CMC, não há 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 interna do CMC e assim por diante.

Requirements

Consulte também

IX509CertificateRequest

IX509CertificateRequestCertificate

IX509CertificateRequestCmc

IX509CertificateRequestPkcs10

IX509CertificateRequestPkcs7

IX509SignatureInformation