GdiplusShutdown-Funktion (gdiplusinit.h)

Artikel
08/24/2023

Die GdiplusShutdown-Funktion bereinigt ressourcen, die von Windows GDI+ verwendet werden. Jeder Aufruf von GdiplusStartup sollte mit einem Aufruf von GdiplusShutdown gekoppelt werden.

Syntax

void GdiplusShutdown(
  ULONG_PTR token
);

Parameter

token

Typ: [in] ULONG_PTR

Token, das von einem vorherigen Aufruf von GdiplusStartup zurückgegeben wird.

Rückgabewert

Keine

Bemerkungen

Sie müssen GdiplusStartup aufrufen, bevor Sie GDI+-Objekte erstellen, und Sie müssen alle Ihre GDI+-Objekte löschen (oder sie aus dem Bereich entfernen), bevor Sie GdiplusShutdown aufrufen.

Hinweis Wenn GDI+ für Windows 7 und früher keine Schriftartenfamilie erstellen kann, ersetzt es die generische Sans Serif-Familie, und clientseitiger Cache des Zeigers für die generische Familie. Da Aufrufe von GdiplusStartup und GdiplusShutdown diese Zwischenspeicherung nicht kennen, behält das Betriebssystem den Zeiger für das generische Familienobjekt über die Lebensdauer des Objekts hinaus bei, wodurch das Betriebssystem abstürzt. Für Windows 8 und höher gibt GDI+ einen Sentinelwert für das generische Familienobjekt zurück, der über Aufrufe von GdiplusStartup und GdiplusShutdown konstant bleibt, sodass das Betriebssystem den Zeiger für das generische Familienobjekt nicht über die Lebensdauer des Objekts hinaus behält.

Beispiele

Ein Beispiel für das Aufrufen von GdiplusStartup und GdiplusShutdown finden Sie unter GdiplusStartup.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusinit.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll

Weitere Informationen