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