FindResourceEx

Funcția FindResourceEx determină locația resursei cu tipul specificat, numele și limba în modulul specificat.

(HRSRC FindResourceEx HMODULE  hModule, / / resurse-modulul mânerLPCTSTRlpType, / / indicatorul de resurse de tipLPCTSTRlpName, / / indicatorul la numele resurseiWORDwLanguage / / limba resurse ) 

Parametrii

hModule
Manipulați cu modulul ale căror executable dosar conține resursa. Dacă acest parametru este NULL, funcția caută modulul utilizat pentru a crea procesul curent.
lpType
Indicatorul la un șir null-terminated care specifică numele tipul resursei. Pentru mai multe informații, consultați secțiunea Comentarii. Pentru tipurile de resurse standard, acest parametru poate fi una dintre următoarele valori:
Valoarea Sensul
RT_ACCELERATOR Accelerator tabel
RT_ANICURSOR Cursorul animate
RT_ANIICON Pictogramă animată
RT_BITMAP Resurse bitmap
RT_CURSOR Cursorul hardware-dependente de resurse
RT_DIALOG Caseta de dialog
RT_FONT Font resurse
RT_FONTDIR Font director de resurse
RT_GROUP_CURSOR Resurse cursorul hardware-independent
RT_GROUP_ICON Resurse independente de articole de fier icon
RT_HTML HTML document
RT_ICON Resurse dependente de articole de fier icon
RT_MENU Meniul resurse
RT_MESSAGETABLE Intrare mesaj-tabel
RT_RCDATA Definite de aplicare resurse (datele primare)
RT_STRING String-tabelul Intrare
RT_VERSION Versiunea resurse

lpName
Indicatorul la un șir null-terminated care specifică numele resursei. Pentru mai multe informații, consultați secțiunea observații.
wLanguage
Specifică limba resursa. Dacă acest parametru este MAKELANGID (LANG_NEUTRAL, SUBLANG_NEUTRAL), limba curentă asociat cu firul de asteptare este utilizat.

Pentru a specifica o altă limbă decât limba curentă, utilizați macrocomanda MAKELANGID pentru a crea acest parametru. Pentru mai multe informații, consultați MAKELANGID.

Valorile întroarse

Dacă funcția reușește, valoarea returnată este un handle-ul specificat al resursei info bloc. Pentru a obține un mâner resursei, trece acest mâner pentru funcția de LoadResource.

Dacă funcția nu reușește, valoarea returnată este NULL. Pentru a obține extins informa?ii eroare, apel GetLastError.

Observații

Dacă high-cuvântul de parametrul lpType sau lpName este zero, cuvântul joasă specifică identificatorul întreg de tip sau nume de resurse dat. În caz contrar, parametrii sunt indicatori null-terminated siruri de caractere. Dacă primul caracter al șirului este un diez (#), caractere rămase reprezintă un număr zecimal care specifică identificatorul întreg numele sau tipul resursei. De exemplu, sirul de caractere "# 258" reprezintă identificatorul întreg 258.

Cererile ar reduce cantitatea de memorie necesară pentru resursele de la le de identificator întreg în loc de numele.

Când ați terminat folosind un accelerator tabel, bitmap, cursorul, pictograma sau meniu, aveți posibilitatea să lansați memorie asociate de una din funcțiile de asteptare în tabelul următor.

Resurse Funcția de presă
Accelerator tabel DestroyAcceleratorTable
Bitmap ȘtergereObiect
Cursorul DestroyCursor
Pictogramă DestroyIcon
Meniul DestroyMenu

Sistemul șterge automat aceste resurse atunci când se termină procesul care le-a creat, cu toate acestea, apel funcția corespunzătoare economisește memorie și Micșorează dimensiunea lui procesul set de lucru.

Cererea poate utiliza FindResourceEx pentru a găsi orice tip de resurse, dar această funcție ar trebui să fie utilizate numai în cazul în care cererea trebuie să acceseze date binare resurse atunci când se face apeluri ulterioare la LoadLibrary și LockResource funcții.

Pentru a utiliza o resursă imediat, cererea trebuie să utilizați următoarele funcții specifice de resurse pentru a găsi și a încărca resursele din un apel:

Funcția Acțiune
FormatMessage Încarcă și formatează o intrare în tabelul de mesaj.
LoadAccelerators Încarcă un tabel accelerator.
LoadBitmap Încarcă o resursă bitmap.
LoadCursor Încarcă o resursă cursorul.
LoadIcon Încarcă o resursă icon.
LoadMenu Încarcă o resursă de meniu.
LoadString Încarcă o intrare în tabelul șir.

De exemplu, o cerere poate funcția LoadIcon pentru a încărca o pictogramă pentru afișare pe ecran. Cu toate acestea, aplicarea ar trebui să utilizați FindResourceEx și LoadResource în cazul în care acesta este de încărcare pictograma pentru a copia datele sale de o altă aplicație.

Șir de resurse sunt stocate în secțiunile de siruri de caractere până la 16 pe secțiune. Siruri de caractere în fiecare sec?iune sunt stocate ca o secvență de numărate șiruri Unicod (nu null-terminated). LoadString funcția va extrage resursă șir din partea corespunzătoare.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Neacceptat.
Antet:A declarat în winbase.h.
Import Biblioteca:Utilizarea kernel32.lib.
Unicode:Pus în aplicare ca versiunile Unicode și ANSI pe Windows și Windows NT.

A se vedea, de asemenea

Ansamblu de resurse, resurse funcții, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadString, LoadResource, MAKELANGID

Index