Compartilhar via


Função GdiplusShutdown (gdiplusinit.h)

A função GdiplusShutdown limpa os recursos usados pelo Windows GDI+. Cada chamada para GdiplusStartup deve ser emparelhada com uma chamada para GdiplusShutdown.

Sintaxe

void GdiplusShutdown(
  ULONG_PTR token
);

Parâmetros

token

Tipo: [in] ULONG_PTR

Token retornado por uma chamada anterior para GdiplusStartup.

Valor retornado

Nenhum

Comentários

Você deve chamar GdiplusStartup antes de criar qualquer objeto GDI+ e excluir todos os objetos GDI+ (ou fazer com que eles saiam do escopo) antes de chamar GdiplusShutdown.

Nota Para o Windows 7 e versões anteriores, se o GDI+ não puder criar uma família de fontes, ele substituirá a família genérica Sans Serif e o lado do cliente armazenará em cache o ponteiro para a família genérica. Como as chamadas para GdiplusStartup e GdiplusShutdown não estão cientes desse cache, o sistema operacional retém o ponteiro para o objeto de família genérico após o tempo de vida do objeto, o que faz com que o sistema operacional falhe. Para o Windows 8 e posteriores, o GDI+ retorna um valor sentinela para o objeto de família genérico que permanece constante entre as chamadas para GdiplusStartup e GdiplusShutdown para que o sistema operacional não mantenha o ponteiro para o objeto de família genérico após o tempo de vida do objeto.
 

Exemplos

Para obter um exemplo de como chamar GdiplusStartup e GdiplusShutdown, consulte GdiplusStartup.

Requisitos

   
Cliente mínimo com suporte Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho gdiplusinit.h (inclua Gdiplus.h)
Biblioteca Gdiplus.lib
DLL Gdiplus.dll

Confira também

GdiplusStartup

GdiplusStartupInput

GdiplusStartupOutput

Introdução