WTSFreeMemoryExA 函数（wtsapi32.h）

项目
11/20/2024

释放包含远程桌面服务函数分配的 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
目标平台	窗户
标头	wtsapi32.h
库	Wtsapi32.lib
DLL	Wtsapi32.dll
API 集	ext-ms-win-session-wtsapi32-l1-1-0（在 Windows 8 中引入）