BeginUpdateResourceA-Funktion (winbase.h)

Artikel
11/20/2024

Ruft ein Handle ab, das von der UpdateResource-Funktion verwendet werden kann, um Ressourcen in einem binärmodul hinzuzufügen, zu löschen oder zu ersetzen.

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 zurzeit 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 Parameter gelöscht werden sollen. Wenn dieser Parameter TRUEist, werden vorhandene Ressourcen gelöscht, und die aktualisierte Datei enthält nur Ressourcen, die mit der funktion UpdateResource hinzugefügt wurden. Wenn dieser Parameter FALSEist, enthält die aktualisierte Datei vorhandene Ressourcen, es sei denn, sie werden explizit gelöscht oder durch UpdateResourceersetzt.

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. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

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 Ressourcenkonfigurationsdaten (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 Funktion UpdateResource.

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

Beispiele

Ein Beispiel finden Sie unter Aktualisieren von Ressourcen.

Anmerkung

Der winbase.h-Header definiert BeginUpdateResource als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winbase.h (enthalten Windows.h)
Library	Kernel32.lib
DLL-	Kernel32.dll