Compartilhar via


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 .

hStore prgpChain Certificados serializados
NULL Não NULL Os certificados apontados pelo membro prgpChain são serializados.
Não NULL NULL Os certificados especificados pelo membro hStore são serializados.
NULL NULL Um BLOB vazio é retornado.
Não NULL Não NULL A chamada falha e a função retorna E_INVALIDARG.

Requisitos

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