Fonction de rappel ENUMRESTYPEPROCA (libloaderapi.h)
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
ENUMRESTYPEPROCA Enumrestypeproca;
BOOL Enumrestypeproca(
[in, optional] HMODULE hModule,
LPSTR 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.
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 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
| 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