Método IX509CertificateRequestPkcs10::InitializeDecode (certenroll.h)

  • Artigo

O método InitializeDecode decodifica uma solicitação de certificado PKCS nº 10 assinada ou não assinada existente e a usa para inicializar o novo objeto de solicitação PKCS #10. A solicitação existente está contida em uma matriz de bytes que foi codificada usando Distinguished Encoding Rules (DER) conforme definido pelo padrão ASN.1 (Abstract Syntax Notation One). A matriz de bytes é representada por uma cadeia de caracteres que é uma sequência binária pura ou é codificada em Unicode.

Sintaxe

HRESULT InitializeDecode(
  [in] BSTR         strEncodedData,
  [in] EncodingType Encoding
);

Parâmetros

[in] strEncodedData

Uma variável BSTR que contém a solicitação codificada em DER. Para obter mais informações, consulte Comentários.

[in] Encoding

Um valor de enumeração EncodingType que especifica o tipo de codificação Unicode aplicada à cadeia de caracteres de entrada que contém a solicitação codificada em DER. O valor padrão é XCN_CRYPT_STRING_BASE64.

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
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 O objeto de solicitação de certificado já foi inicializado.

Comentários

O método InitializeDecode decodifica a solicitação PKCS #10 existente e usa as informações recuperadas para inicializar as seguintes coleções para o novo objeto de solicitação:

O método também:

Por padrão, o método InitializeDecode pressupõe que a solicitação de certificado a ser decodificada é para um usuário final. Começando com Windows 8 e Windows Server 2012, você pode alterar esse comportamento padrão. Depois de criar uma instância da interface IX509CertificateRequestPkcs10 , chame InitializeDecodedefinindo o parâmetro Encoding como XCN_CRYPT_STRING_BINARY e o parâmetro strEncodedData como um dos seguintes valores:

Valor Descrição
L"ContextMachine" A solicitação de certificado codificada é para um computador.
L"ContextUser" A solicitação de certificado codificada é para um usuário final.
L"ContextAdministratorForceMachine" O certificado codificado está sendo solicitado por um administrador que atua em nome de um computador.
 

Em seguida, chame o método InitializeDecode novamente com o certificado codificado definido no argumento strEncodedData .

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

Confira também

IX509CertificateRequestPkcs10