EndUpdateResourceA-Funktion (winbase.h)

Artikel
08/27/2023

Commits oder Verwirft Änderungen, die vor einem Aufruf von UpdateResource vorgenommen wurden.

Syntax

BOOL EndUpdateResourceA(
  [in] HANDLE hUpdate,
  [in] BOOL   fDiscard
);

Parameter

[in] hUpdate

Typ: HANDLE

Ein Modulhandle, das von der BeginUpdateResource-Funktion zurückgegeben und von UpdateResource verwendet wird und auf die zu aktualisierende Datei verweist.

[in] fDiscard

Typ: BOOL

Gibt an, ob die Ressourcenupdates in die Datei geschrieben werden sollen. Wenn dieser Parameter TRUE ist, werden keine Änderungen vorgenommen. Wenn es FALSE ist, werden die Änderungen vorgenommen: Die Ressourcenupdates werden wirksam.

Rückgabewert

Typ: BOOL

Gibt TRUE zurück, wenn die Funktion erfolgreich ist. Andernfalls FALSE . Wenn die Funktion erfolgreich ist und fDiscardtrue ist, werden keine Ressourcenupdates an der Datei vorgenommen. Andernfalls werden alle erfolgreichen Ressourcenupdates an der Datei vorgenommen. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Bevor Sie diese Funktion aufrufen, stellen Sie sicher, dass alle Dateihandles außer dem von BeginUpdateResource zurückgegebenen geschlossen sind.

Diese Funktion kann Ressourcen in Modulen aktualisieren, die sowohl Code als auch Ressourcen enthalten. Es gibt Einschränkungen für Ressourcenupdates in LN-Dateien und MUI-Dateien, die beide Ressourcenkonfigurationsdaten 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 EndUpdateResource 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

Anforderung	Wert
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