Função CryptCATGetAttrInfo (mscat.h)

[A função CryptCATGetAttrInfo está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

A função CryptCATGetAttrInfo recupera informações sobre um atributo de um membro de um catálogo.

Sintaxe

CRYPTCATATTRIBUTE * CryptCATGetAttrInfo(
  [in] HANDLE         hCatalog,
  [in] CRYPTCATMEMBER *pCatMember,
  [in] LPWSTR         pwszReferenceTag
);

Parâmetros

[in] hCatalog

O identificador do catálogo que contém o membro para o qual recuperar as informações de atributo. Esse identificador é obtido chamando a função CryptCATOpen . Esse parâmetro é necessário e não pode ser NULL.

[in] pCatMember

Um ponteiro para uma estrutura CRYPTCATMEMBER que representa o membro para o qual recuperar as informações de atributo. Isso pode ser obtido chamando a função CryptCATGetMemberInfo . Esse parâmetro é necessário e não pode ser NULL.

[in] pwszReferenceTag

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do atributo para o qual recuperar as informações. Esse parâmetro é necessário e não pode ser NULL.

Valor retornado

Essa função retorna um ponteiro para uma estrutura CRYPTCATATTRIBUTE que contém as informações de atributo. Se a função falhar, ela retornará NULL.

Importante Não libere o ponteiro retornado nem nenhum dos membros apontados pelo ponteiro retornado.

 

Se essa função retornar NULL, informações de erro adicionais poderão ser obtidas chamando a função GetLastError . GetLastError retornará um dos seguintes códigos de erro.

Código de retorno	Descrição
CRYPT_E_NOT_FOUND	Não foi possível encontrar o membro ou o atributo .
ERROR_INVALID_PARAMETER	Um ou mais dos parâmetros não são válidos.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mscat.h
Biblioteca	Wintrust.lib
DLL	Wintrust.dll

Confira também

CRYPTCATATTRIBUTE

CRYPTCATMEMBER

CryptCATGetMemberInfo

CryptCATOpen