WTSFreeMemoryExA 函数 (wtsapi32.h)

项目
08/28/2023

释放包含远程桌面服务函数分配的WTS_PROCESS_INFO_EX 或 WTS_SESSION_INFO_1 结构的内存。

语法

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

参数

[in] WTSTypeClass

WTS_TYPE_CLASS 枚举类型的值，该值指定 pMemory 参数引用的缓冲区中包含的结构类型。

[in] pMemory

指向要释放的缓冲区的指针。

[in] NumberOfEntries

pMemory 参数引用的缓冲区中的元素数。

返回值

如果函数成功，则返回值为非零值。

如果函数失败，则返回值为零。若要获得更多的错误信息，请调用 GetLastError 函数。

注解

多个远程桌面服务函数分配缓冲区以返回信息。若要释放包含 WTS_PROCESS_INFO_EX 或 WTS_SESSION_INFO_1 结构的缓冲区，必须调用 WTSFreeMemoryEx 函数。若要释放其他缓冲区，可以调用 WTSFreeMemory 函数或 WTSFreeMemoryEx 函数。

注意

wtsapi32.h 标头将 WTSFreeMemoryEx 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求


最低受支持的客户端	Windows 7
最低受支持的服务器	Windows Server 2008 R2
目标平台	Windows
标头	wtsapi32.h
Library	Wtsapi32.lib
DLL	Wtsapi32.dll
API 集	在 Windows 8 中引入的 ext-ms-win-session-wtsapi32-l1-1-0 ()