Funzione FindResourceW (libloaderapi.h)

Determina la posizione di una risorsa con il tipo e il nome specificati nel modulo specificato.

Per specificare una lingua, usare la funzione FindResourceEx .

Sintassi

HRSRC FindResourceW(
  [in, optional] HMODULE hModule,
  [in]           LPCWSTR lpName,
  [in]           LPCWSTR lpType
);

Parametri

[in, optional] hModule

Tipo: HMODULE

Handle per il modulo il cui file eseguibile portabile o un file MUI adiacente contiene la risorsa. Se questo parametro è NULL, la funzione cerca il modulo usato per creare il processo corrente.

[in] lpName

Tipo: LPCTSTR

Nome della risorsa. In alternativa, anziché un puntatore, questo parametro può essere MAKEINTRESOURCE(ID), dove ID è l'identificatore intero della risorsa. Per altre informazioni, vedere la sezione Osservazioni di seguito.

[in] lpType

Tipo: LPCTSTR

Tipo di risorsa. In alternativa, anziché un puntatore, questo parametro può essere MAKEINTRESOURCE(ID), dove ID è l'identificatore intero del dato

tipo di risorsa. Per i tipi di risorse standard, vedere Tipi di risorse. Per altre informazioni, vedere la sezione Osservazioni di seguito.

Valore restituito

Tipo: HRSRC

Se la funzione ha esito positivo, il valore restituito è un handle per il blocco di informazioni della risorsa specificato. Per ottenere un handle alla risorsa, passare questo handle alla funzione LoadResource .

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Se IS_INTRESOURCE è TRUE per x = lpName o lpType, x specifica l'identificatore intero del nome o del tipo della risorsa specificata. In caso contrario, questi parametri sono puntatori lunghi a stringhe con terminazione null. Se il primo carattere della stringa è un segno di sterlina (#), i caratteri rimanenti rappresentano un numero decimale che specifica l'identificatore intero del nome o del tipo della risorsa. Ad esempio, la stringa "#258" rappresenta l'identificatore intero 258.

Per ridurre la quantità di memoria necessaria per una risorsa, un'applicazione deve fare riferimento a esso in base all'identificatore intero anziché per nome.

Un'applicazione può usare FindResource per trovare qualsiasi tipo di risorsa, ma questa funzione deve essere usata solo se l'applicazione deve accedere ai dati della risorsa binaria eseguendo chiamate successive a LoadResource e quindi a LockResource.

Per usare immediatamente una risorsa, un'applicazione deve usare una delle funzioni specifiche delle risorse seguenti per trovare la risorsa e convertire i dati in un modulo più utilizzabile.

Funzione	Azione
FormatMessage	Carica e formatta una voce della tabella dei messaggi.
LoadAccelerators	Carica una tabella acceleratore.
LoadBitmap	Carica una risorsa bitmap.
LoadCursor	Carica una risorsa cursore.
LoadIcon	Carica una risorsa icona.
LoadMenu	Carica una risorsa di menu.
LoadString	Carica una voce di tabella stringa.

Ad esempio, un'applicazione può usare la funzione LoadIcon per caricare un'icona per la visualizzazione sullo schermo. Tuttavia, l'applicazione deve usare FindResource e LoadResource se carica l'icona per copiare i dati in un'altra applicazione.

Le risorse stringa vengono archiviate in sezioni di fino a 16 stringhe per sezione. Le stringhe in ogni sezione vengono archiviate come sequenza di stringhe Unicode (non necessariamente con terminazione null). La funzione LoadString estrae la risorsa stringa dalla relativa sezione corrispondente.

Esempio

Per un esempio, vedere Aggiornamento delle risorse.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	libloaderapi.h (includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

Informazioni concettuali

FindResourceEx
FormatMessage
IS_INTRESOURCE
LoadAccelerators
LoadBitmap
LoadCursor
LoadIcon
LoadMenu
LoadResource
LoadString
LockResource

Altre risorse

Riferimento

Risorse
SizeofResource