Fonction de rappel ENUMRESNAMEPROCW (libloaderapi.h)
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 ENUMRESNAMEPROC définit un pointeur vers cette fonction de rappel. EnumResNameProc est un espace réservé pour le nom de fonction défini 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 en cours d’énumération. Si ce paramètre a la valeur 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é. Au lieu d’un pointeur, ce paramètre peut également être MAKEINTRESOURCE(ID)
, où ID est une valeur entière représentant un type de ressource prédéfini. Pour connaître 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é. Au lieu d’un pointeur, ce paramètre peut également être MAKEINTRESOURCE(ID)
, où 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 EnumResourceNamesEx . 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.
Notes
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 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) a la valeur 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 en 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 passant son adresse à la fonction EnumResourceNames ou 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 ; à compter de Windows Vista, la dernière valeur d’erreur est ERROR_RESOURCE_ENUM_USER_STOP.
Notes
L’en-tête libloaderapi.h définit ENUMRESNAMEPROC comme un 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.
Configuration requise
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) |
Voir aussi
Conceptuel
Référence