Função CertSelectionGetSerializedBlob (cryptuiapi.h)

A função CertSelectionGetSerializedBlob é uma função auxiliar usada para recuperar um BLOB de certificado serializado de uma estrutura CERT_SELECTUI_INPUT .

Sintaxe

HRESULT CertSelectionGetSerializedBlob(
  [in]  PCERT_SELECTUI_INPUT pcsi,
  [out] void                 **ppOutBuffer,
  [out] ULONG                *pulOutBufferSize
);

Parâmetros

[in] pcsi

Um ponteiro para uma estrutura CERT_SELECTUI_INPUT que contém o repositório de certificados e as informações da cadeia de contexto do certificado.

[out] ppOutBuffer

O endereço de um ponteiro para um buffer que recebe o BLOB de certificados serializados.

[out] pulOutBufferSize

Um ponteiro para um ULONG para receber o tamanho, em bytes, do BLOB recebido no buffer apontado pelo parâmetro ppOutBuffer .

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. Se os parâmetros hStore e prgpChain não forem NULL, retorne E_INVALIDARG. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Comentários

O BLOB serializado retornado é passado para a função CredUIPromptForWindowsCredentials no parâmetro pvInAuthBuffer para permitir que um usuário selecione um certificado usando a interface do usuário de seleção de credenciais.

Os certificados serializados no BLOB retornados no buffer apontado pelo parâmetro ppOutBuffer dessa função dependem dos valores dos membros hStore e prgpChain da estrutura CERT_SELECTUI_INPUT .

Requisitos