UpdateResource

Die UpdateResource -Funktion hinzufügt, löscht oder ersetzt eine Ressource in eine ausführbare Datei.

BOOL UpdateResource) BEHANDELN  hUpdate, / / Update-Datei verarbeitenLPCTSTRlpType, / / Adresse der Ressource Typ aktualisierenLPCTSTRlpName, / / Adresse der Ressource name aktualisierenWortwLanguage, / / Sprachen-ID der RessourceLPVOIDlpData, / / Adresse der RessourcendatenDWORDCbData / / Länge der Ressourcendaten in Bytes);
 

Parameter

hUpdate

Gibt eine Update-Datei-Handle. Dieses Handle wird von der BeginUpdateResource -Funktion zurückgegeben.

lpType

Zeiger auf eine auf Null endende Zeichenfolge angeben des Ressourcentyps der aktualisiert werden. Dieser Parameter kann auch einen ganzzahligen Wert an das MAKEINTRESOURCE -Makro übergeben werden, oder es kann eine der folgenden vordefinierten Ressourcentypen:

Wert	Bedeutung
RT_ACCELERATOR	Zugriffstastentabelle
RT_ANICURSOR	Animierte cursor
RT_ANIICON	Animiertes Symbol
RT_BITMAP	Bitmapressource
RT_CURSOR	Hardware-abhängige Cursor-Ressource
RT_DIALOG	Im Dialogfeld
RT_FONT	Schriftart-Ressource
RT_FONTDIR	Verzeichnis Schriftartressource
RT_GROUP_CURSOR	Hardware-unabhängige Cursor-Ressource
RT_GROUP_ICON	Hardware-unabhängige Symbolressource
RT_HTML	HTML-Dokument
RT_ICON	Hardware-abhängige Symbolressource
RT_MENU	Menüressource
RT_MESSAGETABLE	Nachricht-Tabelleneintrag
RT_RCDATA	Anwendungsdefinierten Ressourcen (Rohdaten)
RT_STRING	Zeichenfolgentabellen-Eintrag
RT_VERSION	Version-Ressource

lpName

Zeiger auf eine auf Null endende Zeichenfolge angeben den Namen der Ressource aktualisiert werden. Dieser Parameter kann auch einen ganzzahligen Wert an das MAKEINTRESOURCE -Makro übergeben sein.

wLanguage

Gibt die Sprachen-ID der Ressource aktualisiert werden. Eine Liste der primären Sprachen-IDs und Teilsprache Bezeichner, die eine Sprachkennung bilden, finden Sie unter der MAKELANGID Makro.

lpData

Zeiger auf die Daten in die ausführbare Datei eingefügt werden soll. Wenn die Ressource auf eine der vordefinierten Typen ist, müssen die Daten gültig und richtig ausgerichtet sein. Beachten Sie, dass dies die unformatierten Binärdaten gespeichert in der ausführbaren Datei, nicht die Daten von LoadIcon, LoadStringoder andere Ressourcen-spezifische Belastung-Funktionen. Alle Daten, Zeichenfolgen oder Text muss im Unicode-Format; LpData muss nicht auf ANSI-Daten zeigen.

Wenn LpData NULL ist, wird die angegebene Ressource aus der ausführbaren Datei gelöscht.

cbData

Gibt die Größe in Bytes, der die Ressourcendaten in lpData.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich NULL.

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

Eine Anwendung kann UpdateResource wiederholt verwenden, um die Daten zu ändern. Jeder Aufruf von UpdateResource trägt zu einer internen Liste von Hinzufügungen, Löschungen und Ersetzungen aber schreibt nicht tatsächlich Daten in die ausführbare Datei. Die Anwendung muss die EndUpdateResource -Funktion verwenden, um die aufgelaufenen Änderungen zu der ausführbaren Datei zu schreiben.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Nicht unterstützt.
Windows CE:Nicht unterstützt.
Header:Deklariert in winbase.h.
Importieren Bibliothek:Verwenden Sie kernel32.lib.
Unicode:Als Unicode und ANSI-Versionen unter Windows NT implementiert.

Siehe auch

Übersicht über Ressourcen, Funktionen, Ressourcen, BeginUpdateResource, EndUpdateResource, LoadIcon, LoadString, LockResource, MAKEINTRESOURCE, MAKELANGID, SizeofResource

Index