BeginUpdateResourceA-Funktion (winbase.h)

Artikel
08/27/2023

Ruft ein Handle ab, das von der UpdateResource-Funktion zum Hinzufügen, Löschen oder Ersetzen von Ressourcen in einem binären Modul verwendet werden kann.

Syntax

HANDLE BeginUpdateResourceA(
  [in] LPCSTR pFileName,
  [in] BOOL   bDeleteExistingResources
);

Parameter

[in] pFileName

Typ: LPCTSTR

Die Binärdatei, in der Ressourcen aktualisiert werden sollen. Eine Anwendung muss in der Lage sein, Schreibzugriff auf diese Datei zu erhalten. Die Datei, auf die von pFileName verwiesen wird, kann derzeit nicht ausgeführt werden. Wenn pFileName keinen vollständigen Pfad angibt, sucht das System nach der Datei im aktuellen Verzeichnis.

[in] bDeleteExistingResources

Typ: BOOL

Gibt an, ob die vorhandenen Ressourcen des pFileName-Parameters gelöscht werden sollen. Wenn dieser Parameter TRUE ist, werden vorhandene Ressourcen gelöscht, und die aktualisierte Datei enthält nur Ressourcen, die mit der UpdateResource-Funktion hinzugefügt wurden. Wenn dieser Parameter FALSE ist, enthält die aktualisierte Datei vorhandene Ressourcen, es sei denn, sie werden mithilfe von UpdateResource explizit gelöscht oder ersetzt.

Rückgabewert

Typ: HANDLE

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle, das von den Funktionen UpdateResource und EndUpdateResource verwendet werden kann. Der Rückgabewert ist NULL , wenn die angegebene Datei kein PE ist, die Datei nicht vorhanden ist oder die Datei nicht zum Schreiben geöffnet werden kann. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Es wird empfohlen, dass die Ressourcendatei nicht geladen wird, bevor diese Funktion aufgerufen wird. Wenn diese Datei jedoch bereits geladen ist, wird kein Fehler zurückgegeben.

Es gibt einige Einschränkungen für Ressourcenupdates in Dateien, die Resource Configuration(RC Config)-Daten enthalten: LN-Dateien und die zugehörigen MUI-Dateien. Details dazu, welche Ressourcentypen in diesen Dateien aktualisiert werden dürfen, finden Sie im Abschnitt Hinweise für die UpdateResource-Funktion .

Diese Funktion kann Ressourcen in Modulen aktualisieren, die sowohl Code als auch Ressourcen enthalten. Wie bereits erwähnt, gibt es Einschränkungen für Ressourcenupdates in LN-Dateien und MUI-Dateien, die beide RC-Konfigurationsdaten enthalten. Details zu den Einschränkungen finden Sie in der Referenz für die UpdateResource-Funktion .

Beispiele

Ein Beispiel finden Sie unter Aktualisieren von Ressourcen.

Hinweis

Der winbase.h-Header definiert BeginUpdateResource als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll