Fonction de rappel ENUMRESNAMEPROCW (libloaderapi.h)

Article
11/20/2024

Fonction de rappel définie par l’application utilisée avec les fonctions EnumResourceNames et EnumResourceNamesEx. Il reçoit le type et le nom d’une ressource. Le type ENUMRESNAMEPRO C définit un pointeur vers cette fonction de rappel. EnumResNameProc est un espace réservé pour le nom de la fonction définie par l’application.

Syntaxe

ENUMRESNAMEPROCW Enumresnameprocw;

BOOL Enumresnameprocw(
  [in, optional] HMODULE hModule,
                 LPCWSTR lpType,
                 LPWSTR lpName,
  [in]           LONG_PTR lParam
)
{...}

Paramètres

[in, optional] hModule

Type : HMODULE

Handle du module dont le fichier exécutable contient les ressources énumérées. Si ce paramètre est null, la fonction énumère les noms de ressources dans le module utilisé pour créer le processus actuel.

lpType

Type : LPCTSTR

Type de ressource pour lequel le nom est énuméré. Sinon, plutôt qu’un pointeur, ce paramètre peut être MAKEINTRESOURCE(ID), où l’ID est une valeur entière représentant un type de ressource prédéfini. Pour les types de ressources standard, consultez Types de ressources. Pour plus d’informations, consultez la section Remarques ci-dessous.

lpName

Type : LPTSTR

Nom d’une ressource du type énuméré. Sinon, plutôt qu’un pointeur, ce paramètre peut être MAKEINTRESOURCE(ID), où l’ID est l’identificateur entier de la ressource. Pour plus d’informations, consultez la section Remarques ci-dessous.

[in] lParam

Type : LONG_PTR

Paramètre défini par l’application passé à la fonction EnumResourceNames ou Fonction EnumResourceNamesEx. Ce paramètre peut être utilisé dans la vérification des erreurs.

Valeur de retour

Type : BOOL

Retourne TRUE pour continuer l’énumération ou FALSE pour arrêter l’énumération.

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 l’identificateur entier du type de ressource. Par exemple, la chaîne « #258 » représente l’identificateur 258.

De même, si IS_INTRESOURCE(lpszName) est TRUE, lpszName spécifie l’identificateur entier de la ressource donnée. 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 l’identificateur entier de la ressource.

Une application doit inscrire cette fonction en transmettant son adresse à la fonction EnumResourceNames ou Fonction EnumResourceNamesEx.

Si la fonction de rappel retourne FALSE, EnumResourceNames ou EnumResourceNamesEx arrête l’énumération et retourne FALSE. Sur Windows XP et les versions antérieures, la valeur obtenue à partir de GetLastError sera ERROR_SUCCESS; à partir de Windows Vista, la dernière valeur d’erreur sera ERROR_RESOURCE_ENUM_USER_STOP.

Note

L’en-tête libloaderapi.h définit ENUMRESNAMEPROC 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 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	libloaderapi.h (include Windows.h)