Compartilhar via

Função WTSFreeMemoryExW (wtsapi32.h)

Libera memória que contém estruturas de WTS_PROCESS_INFO_EX ou WTS_SESSION_INFO_1 alocadas por uma função de Serviços de Área de Trabalho Remota.

Sintaxe

BOOL WTSFreeMemoryExW(
  [in] WTS_TYPE_CLASS WTSTypeClass,
  [in] PVOID          pMemory,
  [in] ULONG          NumberOfEntries
);

Parâmetros

[in] WTSTypeClass

Um valor do tipo de enumeração WTS_TYPE_CLASS que especifica o tipo de estruturas contidas no buffer referenciado pelo parâmetro pMemory.

[in] pMemory

Um ponteiro para o buffer a ser liberado.

[in] NumberOfEntries

O número de elementos no buffer referenciado pelo parâmetro pMemory.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame a função GetLastError.

Observações

Várias funções dos Serviços de Área de Trabalho Remota alocam buffers para retornar informações. Para liberar buffers que contenham estruturas WTS_PROCESS_INFO_EX ou WTS_SESSION_INFO_1, você deve chamar a função WTSFreeMemoryEx. Para liberar outros buffers, você pode chamar a função WTSFreeMemory ou a função WTSFreeMemoryEx.

Nota

O cabeçalho wtsapi32.h define WTSFreeMemoryEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 7
servidor com suporte mínimo Windows Server 2008 R2
da Plataforma de Destino Windows
cabeçalho wtsapi32.h
biblioteca Wtsapi32.lib
de DLL Wtsapi32.dll
conjunto de API ext-ms-win-session-wtsapi32-l1-1-0 (introduzido no Windows 8)

Consulte também

WTSEnumerateProcesses

WTSEnumerateProcessesEx

WTSEnumerateSessions

WTSFreeMemory

WTSQuerySessionInformation

WTSQueryUserConfig

WTS_PROCESS_INFO_EX

WTS_SESSION_INFO_1

  • Last updated on