Fonction EnumResourceNamesA (libloaderapi.h)

  • Article

Énumère les ressources d’un type spécifié dans un module binaire. Pour Windows Vista et versions ultérieures, il s’agit généralement d’un fichier exécutable portable (LN) indépendant du langage, et l’énumération inclut également les ressources des fichiers de ressources spécifiques à la langue correspondants (fichiers .mui) qui contiennent des ressources de langue localisables. Il est également possible pour hModule de spécifier un fichier .mui, auquel cas seul ce fichier est recherché pour les ressources.

Syntaxe

BOOL EnumResourceNamesA(
  [in, optional] HMODULE          hModule,
  [in]           LPCSTR           lpType,
  [in]           ENUMRESNAMEPROCA lpEnumFunc,
  [in]           LONG_PTR         lParam
);

Paramètres

[in, optional] hModule

Type : HMODULE

Handle d’un module à rechercher. À compter de Windows Vista, s’il s’agit d’un fichier LN, les fichiers .mui appropriés (le cas échéant) sont inclus dans la recherche.

Si ce paramètre a la valeur NULL, cela revient à passer un handle au module utilisé pour créer le processus actuel.

[in] lpType

Type : LPCTSTR

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

Valeur retournée

Type : BOOL

La valeur de retour est TRUE si la fonction 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étaillées sur l’erreur, appelez GetLastError.

Remarques

Si IS_INTRESOURCE(lpszType) a la valeur 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 dièse (#), les caractères restants représentent un nombre décimal qui spécifie l’identificateur entier du type de ressource. Par exemple, la chaîne « #258 » représente l’identificateur 258.

Pour chaque ressource trouvée, EnumResourceNames appelle une fonction de rappel définie par l’application lpEnumFunc, en passant le nom ou l’ID de chaque ressource trouvée, ainsi que les différents autres paramètres qui ont été passés à EnumResourceNames.

Les applications peuvent également appeler EnumResourceNamesEx, ce qui fournit un contrôle plus précis des ressources énumérées.

Si une ressource a un ID, l’ID est passé à la fonction de rappel ; sinon, le nom de la ressource est passé à la fonction de rappel. Pour plus d’informations, consultez ENUMRESNAMEPROC.

La fonction EnumResourceNames continue d’énumérer les ressources jusqu’à ce que la fonction de rappel retourne FALSE ou que toutes les ressources aient été énumérées.

À compter de Windows Vista, si hModule spécifie un fichier LN, les ressources énumérées peuvent résider dans le fichier LN ou dans un fichier .mui qui lui est associé. Si aucun fichier .mui n’est trouvé, seules les ressources du fichier LN sont retournées. L’ordre dans lequel les fichiers .mui sont recherchés est l’ordre de recherche habituel du chargeur de ressources ; Pour plus d’informations, consultez Gestion des langues de l’interface utilisateur . Une fois qu’un fichier .mui approprié est trouvé, la recherche de fichier .mui s’arrête. Étant donné que tous les fichiers .mui qui correspondent à un fichier LN unique ont les mêmes types de ressources, seules les ressources du fichier .mui trouvé doivent être énumérées.

L’énumération n’inclut jamais de doublons : si des ressources portant le même nom sont contenues à la fois dans le fichier LN et dans un fichier .mui, la ressource ne sera énumérée qu’une seule fois.

Exemples

Pour obtenir un exemple, consultez Création d’une liste de ressources.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 Build 20348
Serveur minimal pris en charge Windows 10 Build 20348
En-tête libloaderapi.h
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

Conceptuel

Référence