GdiplusShutdown 函式 (gdiplusinit.h)

發行項
08/24/2023

GdiplusShutdown函式會清除 Windows GDI+所使用的資源。每個對 GdiplusStartup 的呼叫都應該與 對 GdiplusShutdown的呼叫配對。

語法

void GdiplusShutdown(
  ULONG_PTR token
);

參數

token

類型：[in] ULONG_PTR

先前呼叫 GdiplusStartup所傳回的權杖。

傳回值

無

備註

您必須在建立任何 GDI+ 物件之前呼叫 GdiplusStartup ，而且必須先刪除所有 GDI+ 物件 (，或讓它們超出範圍) ，才能呼叫 GdiplusShutdown。

注意針對 Windows 7 和更早版本，如果 GDI+ 無法建立字型系列，它會取代泛型 Sans Serif 系列，而用戶端會快取泛型系列指標。由於對 GdiplusStartup 和 GdiplusShutdown 的呼叫並不知道此快取，因此作業系統會保留超出物件存留期的泛型系列物件的指標，這會導致作業系統損毀。針對 Windows 8 和更新版本，GDI+ 會針對泛型系列物件傳回 sentinel 值，在呼叫 GdiplusStartup 和 GdiplusShutdown 時維持不變，因此作業系統不會保留超出物件存留期的泛型系列物件的指標。

範例

如需呼叫 GdiplusStartup 和 GdiplusShutdown的範例，請參閱 GdiplusStartup。

需求


最低支援的用戶端	Windows XP、Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	gdiplusinit.h (包含 Gdiplus.h)
程式庫	Gdiplus.lib
Dll	Gdiplus.dll