CryptCATOpen, fonction (mscat.h)

Article
08/24/2023

[La fonction CryptCATOpen 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 CryptCATOpen ouvre un catalogue et retourne un handle de contexte au catalogue ouvert.

Note Certaines versions antérieures de Wintrust.lib ne contiennent pas les informations d’exportation pour cette fonction. Dans ce cas, vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour établir un lien dynamique vers Wintrust.dll.

Syntaxe

HANDLE CryptCATOpen(
  [in] LPWSTR     pwszFileName,
  [in] DWORD      fdwOpenFlags,
  [in] HCRYPTPROV hProv,
  [in] DWORD      dwPublicVersion,
  [in] DWORD      dwEncodingType
);

Paramètres

[in] pwszFileName

Pointeur vers une chaîne terminée par null pour le nom du fichier catalogue.

[in] fdwOpenFlags

Zéro pour ouvrir un fichier catalogue existant ou une combinaison au niveau du bit d’une ou plusieurs des valeurs suivantes.

Valeur	Signification
CRYPTCAT_OPEN_ALWAYS	Ouvre le fichier, s’il existe, ou crée un fichier, si nécessaire.
CRYPTCAT_OPEN_CREATENEW	Un nouveau fichier catalogue est créé. S’il existe un fichier créé précédemment, il est remplacé.
CRYPTCAT_OPEN_EXISTING	Un fichier catalogue existant est ouvert.
CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES	Un fichier catalogue existant est ouvert. Excluez les hachages de page dans SPC_INDIRECT_DATA.
CRYPTCAT_OPEN_INCLUDE_PAGE_HASHES	Un fichier catalogue existant est ouvert. Incluez les hachages de page dans SPC_INDIRECT_DATA. Le CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES ci-dessus est prioritaire s’il est également défini.
CRYPTCAT_OPEN_VERIFYSIGHASH	Un fichier catalogue existant est ouvert. Vérifie la signature, pas les certificats.
CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG	Un fichier catalogue existant est ouvert. CryptMsgDecode sans contenu.
CRYPTCAT_OPEN_SORTED	Un fichier catalogue existant est ouvert. Does CertCreateContext(CERT_CREATE_CONTEXT_SORTED_FLAG).

[in] hProv

Handle à un fournisseur de services de chiffrement (CSP).

[in] dwPublicVersion

Version du fichier. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
CRYPTCAT_VERSION_1 0x100	Format de fichier version 1.
CRYPTCAT_VERSION_2 0x200	Format de fichier version 2. Windows 8 et Windows Server 2012 : La prise en charge de cette valeur commence.

[in] dwEncodingType

Type d’encodage utilisé pour le fichier. Si cette valeur est 0, le type d’encodage est défini sur PKCS_7_ASN_ENCODING | X509_ASN_ENCODING.

Valeur retournée

En cas de réussite, cette fonction retourne un handle au catalogue ouvert. Une fois que vous avez terminé d’utiliser le handle, fermez-le en appelant la fonction CryptCATClose . La fonction CryptCATOpen retourne INVALID_HANDLE_VALUE en cas d’échec.

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

CryptCATClose

Partager via