LsaFreeMemory 函数 (ntsecapi.h)

  • 项目

LsaFreeMemory 函数释放通过 LSA 函数调用为输出缓冲区分配的内存。 返回可变长度输出缓冲区的 LSA 函数始终代表调用方分配缓冲区。 当不再需要内存时，调用方必须通过将返回的缓冲区指针传递到 LsaFreeMemory 来释放此内存。

语法

NTSTATUS LsaFreeMemory(
  [in] PVOID Buffer
);

参数

[in] Buffer

指向由 LSA 函数调用分配的内存缓冲区的指针。 如果 LsaFreeMemory 成功，则会释放此缓冲区。

返回值

如果函数成功，则返回值STATUS_SUCCESS。

如果函数失败，则返回值是 NTSTATUS 代码，可以是以下值或 LSA 策略函数返回值之一。

返回代码 说明
STATUS_UNSUCCESSFUL
 无法释放内存，因为它不是由 LSA 函数调用分配的。
 

可以使用 LsaNtStatusToWinError 函数将 NTSTATUS 代码转换为 Windows 错误代码。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 ntsecapi.h
Library Advapi32.lib
DLL Advapi32.dll

另请参阅

LSA 策略函数返回值

LsaNtStatusToWinError