Compartilhar via


CoTaskMemFree

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

Essa função libera um bloco de memória tarefa anteriormente alocada por um chamar para o CoTaskMemAlloc Ou CoTaskMemRealloc função.

Syntax

void CoTaskMemFree(
  LPVOID pv
); 

Parameters

  • Vp
    [no] Void ponteiro para bloco de memória para ser liberado.

Return Value

Nenhum.

Remarks

O CoTaskMemFree função, usando o alocador OLE usar como padrão, libera um bloco de memória anteriormente alocado por um chamar para o CoTaskMemAlloc Ou CoTaskMemRealloc função.

O número de bytes liberados é igual o número de bytes que foram originalmente alocados ou realocados. Depois de chamar, bloco de memória apontado pelo Vp é inválido e não poderá mais ser usado.

Passando para esta função qualquer inválido e, em algumas circunstâncias, NULL ponteiros resultam em terminação inesperada do aplicativo.

Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.

Requirements

Header objbase.h
Library ole32.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

CoTaskMemAlloc
CoTaskMemRealloc