CryptCATOpen, fonction (mscat.h)

  • Article

[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