UpdateResource

Funkcja UpdateResource dodaje, usuwa lub zastępuje zasobu w pliku wykonywalnym.

(BOOL UpdateResource UCHWYT  hUpdate, / / dojście do pliku aktualizacjiLPCTSTRlpType, / / adres zasobu wpisz aktualizacjiLPCTSTRlpName, / / adres zasobu Nazwa aktualizacjiProgram WORDwLanguage, / / identyfikator języka zasobuElementem LPVOIDlpData, / / adresu danych zasobuDWORDcbData / / długość danych zasobów, w bajtach);
 

Parametry

hUpdate

Określa dojście do pliku aktualizacji. Ten uchwyt jest zwracana przez funkcję BeginUpdateResource.

lpType

Wskaźnik ciąg zakończony zerem, określający typ zasobu, należy zaktualizować. Tego parametru można także wartość całkowitą przekazany do makra MAKEINTRESOURCE , lub może być jednym z następujących typów zasobów wstępnie zdefiniowanych:

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 mają być aktualizowane. Tego parametru można także wartość całkowitą przekazany do makra MAKEINTRESOURCE.

wLanguage

Określa identyfikator języka zasobów mają być aktualizowane. Aby uzyskać listę identyfikatorów podstawowego języka i identyfikatory odmianą języka, które tworzą identyfikator języka, zobacz MAKELANGID makro.

lpData

Wskaźnik do danych zasobów, który będzie wstawiany do pliku wykonywalnego. Jeśli zasób jest jedną z wstępnie zdefiniowanych typów, dane muszą być ważne i prawidłowo wyrównane. Należy zauważyć, że jest to dane binarne przechowywane w pliku wykonywalnym, nie dane dostarczone przez LoadIcon, LoadStringlub inne funkcje specyficzne dla zasobu obciążenia. Wszystkie dane zawierające ciągi lub tekst musi być w formacie Unicode; lpData nie musi wskazywać na ANSI danych.

Jeśli lpData ma wartość NULL, określony zasób jest usuwany z pliku wykonywalnego.

cbData

Określa rozmiar, w bajtach, danych zasobów na lpData.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest różna od zera.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Aplikację można użyć UpdateResource wielokrotnie dokonywanie zmian w danych zasobów. Każde wywołanie UpdateResource przyczynia się do wewnętrznej listy uzupełnień, usunięć i zamiany, ale nie faktycznie zapisać dane do pliku wykonywalnego. Stosowanie użyć funkcji EndUpdateResource do zapisu zakumulowane zmiany do pliku wykonywalnego.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Nieobsługiwane.
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 NT.

Zobacz też

Przegląd zasobów, działa zasób, BeginUpdateResource, EndUpdateResource, LoadIcon, LoadString, LockResource, MAKEINTRESOURCE, MAKELANGID, SizeofResource

Index