Fonction CryptCATCDFEnumAttributesWithCDFTag

  • Article

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

La fonction CryptCATCDFEnumAttributesWithCDFTag énumère les attributs des fichiers membres dans la section CatalogFiles d’un fichier de définition de catalogue (CDF). CryptCATCDFEnumAttributesWithCDFTag est appelé par MakeCat.

Notes

Cette fonction n’a pas de fichier d’en-tête associé ni de bibliothèque d’importation. Pour appeler cette fonction, vous devez créer un fichier d’en-tête défini par l’utilisateur et utiliser les fonctions LoadLibrary et GetProcAddress pour établir une liaison dynamique vers Mssign32.dll.

 

Syntaxe

CRYPTCATATTRIBUTE* WINAPI CryptCATCDFEnumAttributesWithCDFTag(
  _In_ CRYPTCATCDF                  *pCDF,
  _In_ LPWSTR                       pwszMemberTag,
  _In_ CRYPTCATMEMBER               *pMember,
  _In_ CRYPTCATATTRIBUTE            *pPrevAttr,
  _In_ PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);

Paramètres

pCDF [in]

Pointeur vers une structure CRYPTCATCDF .

pwszMemberTag [in]

Pointeur vers une chaîne terminée par null qui identifie le membre du fichier catalogue.

pMember [in]

Pointeur vers une structure CRYPTCATMEMBER qui contient les informations de membre.

pPrevAttr [in]

Pointeur vers une structure CRYPTCATATTRIBUTE pour un attribut membre de fichier dans le CDF pointé par pCDF.

pfnParseError [in]

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 CryptCATCDFEnumAttributesWithCDFTag retourne un pointeur NULL en cas d’échec.

Notes

Vous appelez généralement cette fonction dans une boucle pour énumérer tous les attributs membres du fichier 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).

    CRYPTCATATTRIBUTE   *pAttr;
    CRYPTCATMEMBER      *pMember;
    LPWSTR              pwszMemberTag;
    CRYPTCATCDF         *pCDF;

    pCDF = CryptCATCDFOpen(L"myCDF", NULL);
    

    pMember = NULL;
    pwszMemberTag = NULL;

    while (pwszMemberTag = CryptCATCDFEnumMembersByCDFTagEx(pCDF,
                                                            pwszMemberTag,
                                                            NULL,
                                                            &pMember,
                                                            FALSE,
                                                            NULL))
    {
        pAttr = NULL;

        while (pAttr = CryptCATCDFEnumAttributesWithCDFTag(pCDF,
                                                           pwszMemberTag,
                                                           pMember,
                                                           pAttr,
                                                           DisplayParseError))
        {
            //do something with pAttr
        }

    }

    CryptCATCDFClose(pCDF);

Spécifications

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

Voir aussi

MakeCat

CRYPTCATATTRIBUTE

CRYPTCATCDF

CRYPTCATMEMBER

GetProcAddress

LoadLibrary