Fonction FindResourceA (winbase.h)

Article
03/06/2024

Détermine l’emplacement d’une ressource avec le type et le nom spécifiés dans le module spécifié.

Pour spécifier une langue, utilisez la fonction FindResourceEx .

Syntaxe

HRSRC FindResourceA(
  [in, optional] HMODULE hModule,
  [in]           LPCSTR  lpName,
  [in]           LPCSTR  lpType
);

Paramètres

[in, optional] hModule

Type : HMODULE

Handle du module dont le fichier exécutable portable ou un fichier MUI associé contient la ressource. Si ce paramètre a la valeur NULL, la fonction recherche le module utilisé pour créer le processus actuel.

[in] lpName

Type : LPCTSTR

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

[in] lpType

Type : LPCTSTR

Type de ressource. 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 connaître les types de ressources standard, consultez Types de ressources. Pour plus d’informations, consultez la section Remarques ci-dessous.

Valeur retournée

Type : HRSRC

Si la fonction réussit, la valeur de retour est un handle du bloc d’informations de la ressource spécifiée. Pour obtenir un handle à la ressource, transmettez ce handle à la fonction LoadResource .

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Si IS_INTRESOURCE a la valeur TRUE pour x = lpName ou lpType, x spécifie l’identificateur entier du nom ou du type de la ressource donnée. Sinon, ces paramètres sont des pointeurs longs vers des chaînes terminées 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 nom ou du type de la ressource. Par exemple, la chaîne « #258 » représente l’identificateur entier 258.

Pour réduire la quantité de mémoire requise pour une ressource, une application doit y faire référence par identificateur entier plutôt que par nom.

Une application peut utiliser FindResource pour rechercher n’importe quel type de ressource, mais cette fonction ne doit être utilisée que si l’application doit accéder aux données de ressource binaires en effectuant des appels ultérieurs à LoadResource , puis à LockResource.

Pour utiliser une ressource immédiatement, une application doit utiliser l’une des fonctions spécifiques aux ressources suivantes pour rechercher la ressource et convertir les données dans un formulaire plus utilisable.

Fonction	Action
FormatMessage	Charge et met en forme une entrée de table de messages.
LoadAccelerators	Charge une table d’accélérateur.
LoadBitmap	Charge une ressource bitmap.
LoadCursor	Charge une ressource de curseur.
LoadIcon	Charge une ressource d’icône.
LoadMenu	Charge une ressource de menu.
LoadString	Charge une entrée de table de chaînes.

Par exemple, une application peut utiliser la fonction LoadIcon pour charger une icône à afficher à l’écran. Toutefois, l’application doit utiliser FindResource et LoadResource si elle charge l’icône pour copier ses données dans une autre application.

Les ressources de chaîne sont stockées dans des sections de 16 chaînes maximum par section. Les chaînes de chaque section sont stockées sous la forme d’une séquence de chaînes Unicode comptées (pas nécessairement terminées par null). La fonction LoadString extrait la ressource de chaîne de sa section correspondante.

Exemples

Pour obtenir un exemple, consultez Mise à jour des ressources.

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	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll