Fonction CryptCATGetAttrInfo (mscat.h)

Article
08/24/2023

[La fonction CryptCATGetAttrInfo est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

La fonction CryptCATGetAttrInfo récupère des informations sur un attribut d’un membre d’un catalogue.

Syntaxe

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

Paramètres

[in] hCatalog

Handle du catalogue qui contient le membre pour lequel récupérer les informations d’attribut. Ce handle est obtenu en appelant la fonction CryptCATOpen . Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.

[in] pCatMember

Pointeur vers une structure CRYPTCATMEMBER qui représente le membre pour lequel récupérer les informations d’attribut. Vous pouvez l’obtenir en appelant la fonction CryptCATGetMemberInfo . Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.

[in] pwszReferenceTag

Pointeur vers une chaîne Unicode terminée par null qui contient le nom de l’attribut pour lequel récupérer les informations. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.

Valeur retournée

Cette fonction retourne un pointeur vers une structure CRYPTCATATTRIBUTE qui contient les informations d’attribut. Si la fonction échoue, elle retourne NULL.

Important Ne libérez pas le pointeur retourné ni aucun des membres pointés par le pointeur retourné.

Si cette fonction retourne null, des informations d’erreur supplémentaires peuvent être obtenues en appelant la fonction GetLastError . GetLastError retourne l’un des codes d’erreur suivants.

Code de retour	Description
CRYPT_E_NOT_FOUND	Le membre ou l’attribut est introuvable.
ERROR_INVALID_PARAMETER	Un ou plusieurs des paramètres ne sont pas valides.

Spécifications


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mscat.h
Bibliothèque	Wintrust.lib
DLL	Wintrust.dll

Voir aussi

CRYPTCATATTRIBUTE

CRYPTCATMEMBER

CryptCATGetMemberInfo

CryptCATOpen