CryptCATCDFEnumCatAttributes, fonction (mscat.h)

[La fonction CryptCATCDFEnumCatAttributes est disponible pour ê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.]

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 fichier.

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 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.

Examples

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);

Spécifications

Voir aussi

CRYPTCATATTRIBUTE

CRYPTCATCDF

MakeCat