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

Voir aussi

CRYPTCATATTRIBUTE

CRYPTCATCDF

MakeCat