FindResourceEx

Funkcja FindResourceEx określa lokalizację zasobu z określonego typu, nazwy i języka określonego modułu.

(HRSRC FindResourceEx HMODULE  hModule, / / zasobu moduł obsługiLPCTSTRlpType, / / wskaźnik do zasobu wpiszLPCTSTRlpName, / / wskaźnik nazwa zasobuProgram WORDwLanguage / / zasobów językowych ) 

Parametry

hModule

Uchwyt do modułu, którego plik wykonywalny zawiera zasób. Jeśli ten parametr ma wartość NULL, funkcja szuka modułu używany do tworzenia bieżącego procesu.

lpType

Wskaźnik ciąg zakończony zerem, określający nazwę typu zasobu. Aby uzyskać więcej informacji zobacz sekcję Spostrzeżenia. Dla typów zasobów standardowe ten parametr może być jedna z następujących wartości:

Wartość	Znaczenie
RT_ACCELERATOR	Akcelerator tabeli
RT_ANICURSOR	Animowanych kursorów
RT_ANIICON	Animowana ikona
RT_BITMAP	Mapa bitowa zasobów
RT_CURSOR	Zależne od sprzętu kursor zasobów
RT_DIALOG	Okno dialogowe
RT_FONT	Zasób czcionki
RT_FONTDIR	Zasób katalogu czcionki
RT_GROUP_CURSOR	Kursor niezależną od sprzętu zasobów
RT_GROUP_ICON	Ikona niezależną od sprzętu zasobów
RT_HTML	Dokument HTML
RT_ICON	Zależne od sprzętu ikonę zasobu
RT_MENU	Menu zasobów
RT_MESSAGETABLE	Wiadomości-spisu
RT_RCDATA	Zdefiniowane przez aplikację zasobów (nieprzetworzone dane)
RT_STRING	Ciąg-spisu
RT_VERSION	Wersja zasobów

lpName

Wskaźnik ciąg zakończony zerem, określający nazwę zasobu. Aby uzyskać więcej informacji zobacz sekcję Spostrzeżenia.

wLanguage

Określa język zasobu. Jeśli ten parametr jest MAKELANGID (LANG_NEUTRAL, SUBLANG_NEUTRAL), używany jest język bieżące związane z wywołania wątku.

Aby określić język inny niż bieżący język, należy użyć makra MAKELANGID do utworzenia tego parametru. Aby uzyskać więcej informacji, zobacz MAKELANGID.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest dojście do określonego zasobu o użytkowniku bloku. Aby uzyskać dojścia do zasobu, przekazać to dojście do funkcji LoadResource.

Jeśli funkcja zawiedzie, wartość zwracana jest wartość NULL. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Jeśli słowo wysokiej parametr lpType lub lpName jest równe zero, wyraz niskiej określa identyfikator całkowitą typu lub nazwa danego zasobu. W przeciwnym razie tych parametrów są wskaźniki do ciągów zakończona znakiem null. Jeśli pierwszego znaku ciągu jest znak krzyżyka (#), pozostałe znaki reprezentują liczbę dziesiętną, który określa identyfikator całkowitą nazwy lub typu zasobu. Na przykład ciąg "# 258" reprezentuje identyfikator całkowitą 258.

Wnioski należy zmniejszyć ilość pamięci wymaganej dla zasobów przez odnoszące się do nich przez całkowitą identyfikator zamiast przez nazwę.

Po zakończeniu przy użyciu tabeli akceleratora, bitmapy, kursor, ikona lub menu, można zwolnić jego skojarzony pamięci, wywołując jedną z funkcji w poniższej tabeli.

System automatycznie usuwa te zasoby, gdy kończy proces, który je utworzył, jednak wywołanie odpowiedniej funkcji Oszczędza pamięć i zmniejsza rozmiar zestawu roboczego procesu.

Aplikacja może używać FindResourceEx aby znaleźć dowolnego typu zasobu, ale funkcja ta stosuje się tylko, jeżeli aplikacji musi uzyskać dostęp do danych binarnych zasobów, dokonując kolejnych zaproszeń do funkcje LoadLibrary i LockResource.

Aby użyć zasobu natychmiast, aplikacji należy użyć następujące funkcje specyficzne dla zasobu do załadowania zasobów w jedno wywołanie:

Na przykład aplikacja można użyć funkcji LoadIcon załadować ikonę do wyświetlania na ekranie. Jednakże stosowanie należy używać FindResourceEx i LoadResource , jeżeli jest ładowanie tę ikonę, aby skopiować dane do innej aplikacji.

Zasobów ciągu są przechowywane w sekcjach maksymalnie 16 ciągów ppkt. Ciągi w każdej sekcji są przechowywane jako sekwencja zliczona ciągów Unicode (nie zakończonymi znakiem null). LoadString funkcji zostaną wyodrębnione zasobu ciągu z jego odpowiedniej sekcji.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w winbase.h.
Importowanie biblioteki:Należy użyć kernel32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows i Windows NT.

Zobacz też

Przegląd zasobów, funkcji zasobów, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadString, LoadResource, MAKELANGID

Index