CryptCATPutAttrInfo, fonction (mscat.h)

Article
03/13/2024

[La fonction CryptCATPutAttrInfo peut être utilisée 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 CryptCATPutAttrInfo alloue de la mémoire à un attribut et l’ajoute à un membre du catalogue.

Syntaxe

CRYPTCATATTRIBUTE * CryptCATPutAttrInfo(
  [in] HANDLE         hCatalog,
  [in] CRYPTCATMEMBER *pCatMember,
  [in] LPWSTR         pwszReferenceTag,
  [in] DWORD          dwAttrTypeAndAction,
  [in] DWORD          cbData,
  [in] BYTE           *pbData
);

Paramètres

[in] hCatalog

Handle du catalogue obtenu à partir de la fonction CryptCATOpen ou CryptCATHandleFromStore .

[in] pCatMember

Pointeur vers une structure CRYPTCATMEMBER qui contient le membre du catalogue.

[in] pwszReferenceTag

Pointeur vers une chaîne terminée par null qui contient le nom de l’attribut.

[in] dwAttrTypeAndAction

Valeur qui représente une combinaison au niveau du bit des indicateurs suivants. L’appelant doit au moins spécifier CRYPTCAT_ATTR_DATABASE64 ou CRYPTCAT_ATTR_DATAASCII.

Valeur	Signification
CRYPTCAT_ATTR_AUTHENTICATED 0x10000000	L’attribut est authentifié.
CRYPTCAT_ATTR_UNAUTHENTICATED 0x20000000	L’attribut n’est pas authentifié.
CRYPTCAT_ATTR_NAMEASCII 0x00000001	L’attribut est une chaîne ASCII.
CRYPTCAT_ATTR_NAMEOBJID 0x00000002	L’attribut est un identificateur d’objet de chiffrement (OID).
CRYPTCAT_ATTR_DATAASCII 0x00010000	L’attribut contient des caractères ASCII simples qui ne doivent pas être décodés.
CRYPTCAT_ATTR_DATABASE64 0x00020000	L’attribut est au format base 64.
CRYPTCAT_ATTR_DATAREPLACE 0x00040000	L’attribut remplace la valeur d’un attribut existant.

[in] cbData

Valeur qui spécifie le nombre d’octets dans la mémoire tampon pbData .

[in] pbData

Pointeur vers une mémoire tampon qui contient la valeur d’attribut.

Valeur retournée

En cas de réussite, cette fonction retourne un pointeur vers une structure CRYPTCATATTRIBUTE qui contient l’attribut attribué. L’appelant ne doit pas libérer ce pointeur ou l’un de ses membres.

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
ERROR_INVALID_PARAMETER	Un ou plusieurs paramètres ne sont pas valides.
ERROR_NOT_ENOUGH_MEMORY	Le système d’exploitation a manqué de mémoire pendant l’opération.

Configuration requise

Condition requise	Valeur
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

Partager via