Fonction EnumResourceNamesExA (libloaderapi.h)
Énumère les ressources d’un type spécifié associé à un module binaire spécifié. La recherche peut inclure à la fois un fichier LN et ses fichiers .mui associés, ou il peut être limité de plusieurs façons.
Syntaxe
BOOL EnumResourceNamesExA(
[in, optional] HMODULE hModule,
LPCSTR lpType,
[in] ENUMRESNAMEPROCA lpEnumFunc,
[in] LONG_PTR lParam,
[in] DWORD dwFlags,
[in] LANGID LangId
);
Paramètres
[in, optional] hModule
Type : HMODULE
Handle d’un module à rechercher. En règle générale, il s’agit d’un fichier LN et, si l’indicateur RESOURCE_ENUM_MUI est défini, les fichiers .mui appropriés sont inclus dans la recherche. Sinon, il peut s’agir d’un handle vers un fichier .mui ou un autre fichier LN.
Si ce paramètre est null, il équivaut à passer un handle au module utilisé pour créer le processus actuel.
lpType
Type : LPCSTR
Type de la ressource pour laquelle le nom est énuméré. Sinon, plutôt qu’un pointeur, ce paramètre peut être MAKEINTRESOURCE(ID), où ID est une valeur entière représentant un type de ressource prédéfini. Pour obtenir la liste des types de ressources prédéfinis, consultez types de ressources. Pour plus d’informations, consultez la section Remarques ci-dessous.
[in] lpEnumFunc
Type : ENUMRESNAMEPROC
Pointeur vers la fonction de rappel à appeler pour chaque nom de ressource énuméré. Pour plus d’informations, consultez EnumResNameProc.
[in] lParam
Type : LONG_PTR
Valeur définie par l’application passée à la fonction de rappel. Ce paramètre peut être utilisé dans la vérification des erreurs.
[in] dwFlags
Type : DWORD
Type de fichier à rechercher. Les valeurs suivantes sont prises en charge. Notez que si dwFlags est égal à zéro, les indicateurs RESOURCE_ENUM_LN et RESOURCE_ENUM_MUI sont supposés être spécifiés.
| Valeur | Signification |
|---|---|
|
Recherchez des ressources dans les fichiers .mui associés au fichier LN spécifié par hModule et avec les préférences linguistiques actuelles, en suivant la stratégie de chargeur de ressources habituelle (voir Gestion du langage de l’interface utilisateur). Sinon, si LangId n’est pas zéro, seul le fichier .mui spécifié sera recherché. En règle générale, cet indicateur ne doit être utilisé que si hModule fait référence à un fichier LN. Si hModule fait référence à un fichier .mui, ce fichier est réellement couvert par l’indicateur RESOURCE_ENUM_LN, malgré le nom de l’indicateur. |
|
Recherche le fichier spécifié par hModule, que le fichier soit un fichier LN, un autre type de fichier LN ou un fichier .mui. |
|
Effectue une validation supplémentaire sur la section de ressource et sa référence dans l’en-tête PE tout en effectuant l’énumération pour vous assurer que les ressources sont correctement mises en forme. La validation définit une limite maximale de 260 caractères pour chaque nom énuméré. |
[in] LangId
Type : LANGID
Langage de localisation utilisé pour filtrer la recherche dans le module MUI. Ce paramètre est utilisé uniquement lorsque l’indicateur de RESOURCE_ENUM_MUI est défini dans dwFlags. Si zéro est spécifié, tous les fichiers .mui qui correspondent aux préférences linguistiques actuelles sont inclus dans la recherche, en suivant la stratégie habituelle du chargeur de ressources (voir Gestion du langage de l’interface utilisateur). Si un LangId différent de zéro est spécifié, le seul fichier .mui recherché sera celui correspondant à l'LangId spécifié.
Valeur de retour
Type : BOOL
La fonction TRUE si elle réussit, ou FALSE si la fonction ne trouve pas de ressource du type spécifié, ou si la fonction échoue pour une autre raison. Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Remarques
Si IS_INTRESOURCE(lpszType) est TRUE, lpszType spécifie l’identificateur entier du type de ressource donné. Sinon, il s’agit d’un pointeur vers une chaîne terminée par null. Si le premier caractère de la chaîne est un signe de livre (#), les caractères restants représentent un nombre décimal qui spécifie le
identificateur entier du type de ressource. Par exemple, la chaîne « #258 » représente l’identificateur 258.
La recherche d’énumération peut inclure à la fois un fichier LN et ses fichiers .mui associés. Il peut être limité à un seul module binaire de n’importe quel type. Il peut également être limité aux fichiers .mui associés à un seul fichier LN. En spécifiant un fichier LN pour le paramètre hModule et un paramètre LangId non zéro, la recherche peut être limitée au fichier .mui unique associé à ce fichier et à cette langue LN.
Pour chaque ressource trouvée, EnumResourceNamesEx appelle une fonction de rappel définie par l’application lpEnumFunc, en passant le nom ou l’ID de chaque ressource qu’elle trouve, ainsi que les différents autres paramètres passés à EnumResourceNamesEx.
Si une ressource a un ID, l’ID est retourné à la fonction de rappel ; sinon, le nom de la ressource est retourné à la fonction de rappel. Pour plus d’informations, consultez EnumResNameProc.
La fonction EnumResourceNamesEx continue d’énumérer les noms de ressources jusqu’à ce que la fonction de rappel retourne FAUX ou tous les noms de ressources pour ce type ont été énumérés.
Si hModule spécifie un fichier LN et que les deux indicateurs sont sélectionnés, les noms énumérés correspondent aux ressources résidant dans ce fichier LN ou dans les fichiers .mui associés. Si aucun fichier .mui n’est trouvé, seuls les noms du fichier LN sont retournés. Une fois qu’un fichier .mui approprié est trouvé, la recherche ne se poursuit pas plus loin, car tous les fichiers .mui correspondant à un seul fichier LN ont les mêmes noms de ressources.
Si dwFlags et LangId sont tous deux zéro, la fonction se comporte comme EnumResourceNames.
Si LangId n’est pas zéro, seul le fichier .mui correspondant à cet identificateur de langue sera recherché. Les secours linguistiques ne seront pas utilisés. Si un fichier .mui pour cette langue n’existe pas, l’énumération est vide (sauf si les ressources de cette langue existent dans le fichier LN et que l’indicateur est également défini pour rechercher le fichier LN).
L’énumération n’inclut jamais de doublons : si les ressources d’une langue particulière sont contenues dans le fichier LN et dans un fichier .mui, le nom ne sera énuméré qu’une seule fois.
Exemples
Pour obtenir un exemple, consultez Création d’une liste de ressources.
Note
L’en-tête libloaderapi.h définit EnumResourceNamesEx comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | libloaderapi.h (include Windows.h) |
| bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |
Voir aussi
conceptuelle
de référence