CryptCATCDFOpen, fonction (mscat.h)

Article
02/29/2024

[La fonction CryptCATCDFOpen 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.]

Structure CRYPTCATCDF . CryptCATCDFOpen est appelé par MakeCat.

Syntaxe

CRYPTCATCDF * CryptCATCDFOpen(
  [in]           LPWSTR                       pwszFilePath,
  [in, optional] PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);

Paramètres

[in] pwszFilePath

Pointeur vers une chaîne terminée par null qui contient le chemin d’accès du fichier CDF à ouvrir.

[in, optional] pfnParseError

Pointeur vers une fonction définie par l’utilisateur pour gérer les erreurs d’analyse de fichiers.

Valeur retournée

En cas de réussite, cette fonction retourne un pointeur vers la structure CRYPTCATCDF nouvellement créée. La fonction CryptCATCDFOpen retourne un pointeur NULL en cas d’échec.

Remarques

Les valeurs par défaut suivantes sont utilisées par la fonction CryptCATCDFOpen pour des conditions données dans la section CDF CatalogHeader .

Condition CatalogHeader	Valeur par défaut
Aucune valeur name n’est spécifiée.	Le nom de fichier dans pwszFilePath est utilisé pour le fichier de sortie catalog (.cat).
Aucune valeur PublicVersion n’est spécifiée.	0x00000001
Aucune valeur EncodingType n’est spécifiée.	PKCS_7_ASN_ENCODING ou X509_ASN_ENCODING (0x00010001)

Les actions suivantes sont effectuées par la fonction CryptCATCDFOpen pour des conditions d’erreur données.

État d’erreur	Action effectuée
Aucune étiquette CatalogHeader ou Name n’est trouvée dans CDF.	Si elle est spécifiée par l’appelant, la fonction CryptCATCDFOpen appelle la fonction spécifiée par pfnParseError et retourne un pointeur NULL .
La fonction CryptCATCDFOpen appelle la fonction CryptCATOpen pour obtenir un handle dans le fichier de sortie du catalogue (.cat), mais elle obtient un handle non valide ou NULL .	Appelle la fonction CryptCATCDFClose et retourne un pointeur NULL .

OID supplémentaires pour la branche catalog	Définition
szOID_CATALOG_LIST_MEMBER_V2	1.3.6.1.4.1.311.12.1.3
CAT_MEMBERINFO2_OBJID	1.3.6.1.4.1.311.12.2.3

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Les OID de catalogue supplémentaires ne sont pas disponibles.

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
DLL	Wintrust.dll

Voir aussi