CryptCATCDFEnumMembersByCDFTagEx, fonction

[La fonction CryptCATCDFEnumMembersByCDFTagEx 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 CryptCATCDFEnumMembersByCDFTagEx énumère les membres de fichier individuels dans la section CatalogFiles d’un fichier de définition de catalogue (CDF). CryptCATCDFEnumMembersByCDFTagEx 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

LPWSTR WINAPI CryptCATCDFEnumMembersByCDFTagEx(
  _In_    CRYPTCATCDF                  *pCDF,
  _Inout_ LPWSTR                       pwszPrevCDFTag,
  _In_    PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError,
  _In_    CRYPTCATMEMBER               **ppMember,
  _In_    BOOL                         fContinueOnError,
  _In_    LPVOID                       pvReserved
);

Paramètres

pCDF [in]

Pointeur vers une structure CRYPTCATCDF .

pwszPrevCDFTag [in, out]

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

pfnParseError [in]

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

ppMember [in]

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

fContinueOnError [in]

Valeur qui spécifie s’il faut conserver en mémoire une référence au dernier membre énuméré.

pvReserved [in]

Ce paramètre est réservé ; ne l’utilisez pas.

Valeur retournée

En cas de réussite, cette fonction retourne un pointeur vers une chaîne terminée par null qui identifie un membre de fichier dans la section CatalogFiles d’un fichier CDF. La fonction CryptCATCDFEnumMembersByCDFTagEx retourne un pointeur NULL en cas d’échec.

Notes

Vous appelez généralement cette fonction dans une boucle pour énumérer tous les membres du fichier catalogue dans un CDF. Avant d’entrer dans la boucle, définissez pwszPrevCDFTag surNULL. La fonction retourne un pointeur vers le premier membre. Définissez pwszPrevCDFTag 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 pwszPrevCDFTag (pwszMemberTag).

    CRYPTCATMEMBER      *pMember;
    LPWSTR              pwszMemberTag;
    CRYPTCATCDF         *pCDF;

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

    pMember = NULL;
    pwszMemberTag = NULL;

    while (pwszMemberTag = CryptCATCDFEnumMembersByCDFTagEx(pCDF,
                                                            pwszMemberTag,
                                                            NULL,
                                                            &pMember,
                                                            FALSE,
                                                            NULL))
    {
        //do something with pwszMemberTag and pMember
    }

    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

CRYPTCATCDF

CRYPTCATMEMBER

GetProcAddress

LoadLibrary