Função WTSFreeMemoryExA (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 WTSFreeMemoryExA(
[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
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
WTSEnumerateProcessesEx