Funzione GdiplusShutdown (gdiplusinit.h)

Articolo
08/24/2023

La funzione GdiplusShutdown pulisce le risorse usate da Windows GDI+. Ogni chiamata a GdiplusStartup deve essere associata a una chiamata a GdiplusShutdown.

Sintassi

void GdiplusShutdown(
  ULONG_PTR token
);

Parametri

token

Tipo: [in] ULONG_PTR

Token restituito da una chiamata precedente a GdiplusStartup.

Valore restituito

nessuno

Osservazioni

È necessario chiamare GdiplusStartup prima di creare oggetti GDI+ ed è necessario eliminare tutti gli oggetti GDI+ (o uscire dall'ambito) prima di chiamare GdiplusShutdown.

Nota Per Windows 7 e versioni precedenti, se GDI+ non riesce a creare una famiglia di caratteri, sostituisce la famiglia generica Sans Serif e il puntatore sul lato client per la famiglia generica. Poiché le chiamate a GdiplusStartup e GdiplusShutdown non sono consapevoli di questa memorizzazione nella cache, il sistema operativo mantiene il puntatore per l'oggetto famiglia generico oltre la durata dell'oggetto, che causa l'arresto anomalo del sistema operativo. Per Windows 8 e versioni successive, GDI+ restituisce un valore sentinel per l'oggetto famiglia generico che rimane costante tra le chiamate a GdiplusStartup e GdiplusShutdown in modo che il sistema operativo non mantenga il puntatore per l'oggetto famiglia generico oltre la durata dell'oggetto.

Esempio

Per un esempio di chiamata a GdiplusStartup e GdiplusShutdown, vedere GdiplusStartup.

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusinit.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll