Fonction de rappel ENUMRESTYPEPROCW (libloaderapi.h)

Article
02/28/2024

Fonction de rappel définie par l’application utilisée avec les fonctions EnumResourceTypes et EnumResourceTypesEx . Il reçoit les types de ressources. Le type ENUMRESTYPEPROC définit un pointeur vers cette fonction de rappel. EnumResTypeProc est un espace réservé pour le nom de fonction défini par l’application.

Syntaxe

ENUMRESTYPEPROCW Enumrestypeprocw;

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

Paramètres

[in, optional] hModule

Type : HMODULE

Handle du module dont le fichier exécutable contient les ressources pour lesquelles les types doivent être énumérés. Si ce paramètre a la valeur NULL, la fonction énumère les types de ressources dans le module utilisé pour créer le processus actuel.

lpType

Type : LPTSTR

Type de ressource pour lequel le type est énuméré.

Sinon, plutôt qu’un pointeur, ce paramètre peut être MAKEINTRESOURCE(ID), où ID est l’identificateur entier du type de ressource donné. Pour les types de ressources standard, consultez Types de ressources. 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 EnumResourceTypes ou EnumResourceTypesEx . Ce paramètre peut être utilisé dans la vérification des erreurs.

Valeur retournée

Type : BOOL

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

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.

Une application doit inscrire cette fonction en passant son adresse à la fonction EnumResourceTypes ou EnumResourceTypesEx .

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

Notes

L’en-tête libloaderapi.h définit ENUMRESTYPEPROC en tant qu’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. La combinaison 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	libloaderapi.h (inclure Windows.h)