Fonction de rappel ENUMRESTYPEPROCW (libloaderapi.h)

Article
11/20/2024

Fonction de rappel définie par l’application utilisée avec les fonctions EnumResourceTypes et Fonctions EnumResourceTypesEx. Il reçoit des 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 la fonction définie 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 est 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, au lieu d’un pointeur, ce paramètre peut être MAKEINTRESOURCE(ID), où l’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 Fonction EnumResourceTypesEx. 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.

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

Si la fonction de rappel retourne FALSE, EnumResourceTypes ou EnumResourceTypesEx 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 ENUMRESTYPEPROC 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)