Fonction CryptCATCDFEnumCatAttributes (mscat.h)
[La fonction CryptCATCDFEnumCatAttributes 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 CryptCATCDFEnumCatAttributes énumère les attributs au niveau du catalogue dans la section CatalogHeader d’un fichier de définition de catalogue (CDF). CryptCATCDFEnumCatAttributes est appelé par MakeCat.
Syntaxe
CRYPTCATATTRIBUTE * CryptCATCDFEnumCatAttributes(
[in] CRYPTCATCDF *pCDF,
[in] CRYPTCATATTRIBUTE *pPrevAttr,
[in] PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);
Paramètres
[in] pCDF
Pointeur vers une structure CRYPTCATCDF .
[in] pPrevAttr
Pointeur vers une structure CRYPTCATATTRIBUTE pour un attribut de catalogue dans le CDF pointé par pCDF.
[in] 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 une structure CRYPTCATATTRIBUTE . La fonction CryptCATCDFEnumCatAttributes retourne un pointeur NULL en cas d’échec.
Remarques
Vous appelez généralement cette fonction dans une boucle pour énumérer tous les attributs d’en-tête de catalogue dans un CDF. Avant d’entrer dans la boucle, définissez pPrevAttr sur NULL. La fonction retourne un pointeur vers le premier attribut. Définissez pPrevAttr sur la valeur de retour de la fonction pour les itérations suivantes de la boucle.
Exemples
L’exemple suivant montre la séquence correcte d’affectations pour le paramètre pPrevAttr (pAttr).
CRYPTCATCDF *pCDF;
CRYPTCATATTRIBUTE *pAttr;
pCDF = CryptCATCDFOpen(L"myCDF", NULL);
pAttr = NULL;
while (pAttr = CryptCATCDFEnumCatAttributes(pCDF, pAttr, NULL))
{
//do something with pAttr
}
CryptCATCDFClose(pCDF);
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 |