FindResource

Funcţia FindResource determină locaţia o resursă cu tipul specificat şi numele modulului specifică.

(HRSRC FindResource HMODULE  hModule, / / modulul mânerLPCTSTRlpName, / / indicatorul la numele resurseiLPCTSTRlpType / / indicatorul de resurse de tip);
 

Parametrii

hModule

Mâner pentru modulul ale căror executable dosar conţine resursa.

O valoare NULL specifică ghidajul de modulul asociat cu fişierul de imagine pe care sistemul de operare utilizat pentru a crea procesul curent.

lpName

Specifică numele resursei. Pentru mai multe informaţii, consultaţi secţiunea observaţii.

lpType

Specifică 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

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

În cazul în care cuvântul high-ordinea de parametrul lpName sau lpType este zero, cuvântul-low-comandă identificatorul întreg numele sau tipul de resurse dat. În caz contrar, parametrii sunt indicatori lung 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.

O cerere 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.

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 FindResource 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.

Pentru a utiliza o resursă imediat, cererea ar trebui să utilizaţi una din următoarele func?ii specifice de resurse pentru a găsi şi a încărca resursele din un apel:

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 FindResource ş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.

Windows CE: Parametrul hModule nu poate fi un handle NULL.

Parametrul lpName nu acceptă Identificatorul de resursă zero — adică, FindResource (h, 0, t) nu va funcţiona cum era de aşteptat.

Tu nu poate trece valorile RT_ANICURSOR sau RT_ANIICON în parametrul lpType .

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
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, FindResourceEx, FormatMessage, LoadAccelerators, , LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadResource, LoadString, LockResource, SizeofResource

Index