Функция LsaFreeMemory (ntsecapi.h)

  • Статья

Функция LsaFreeMemory освобождает память, выделенную для выходного буфера с помощью вызова функции LSA. Функции LSA, возвращающие выходные буферы переменной длины, всегда выделяют буфер от имени вызывающего объекта. Вызывающий объект должен освободить эту память, передав возвращаемый указатель буфера в LsaFreeMemory , когда память больше не требуется.

Синтаксис

NTSTATUS LsaFreeMemory(
  [in] PVOID Buffer
);

Параметры

[in] Buffer

Указатель на буфер памяти, выделенный вызовом функции LSA. В случае успешного выполнения LsaFreeMemory этот буфер освобождается.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет STATUS_SUCCESS.

Если функция завершается сбоем, возвращаемым значением будет код NTSTATUS, который может быть следующим значением или одним из возвращаемых значений функции политики LSA.

Код возврата Описание
STATUS_UNSUCCESSFUL
 Не удалось освободить память, так как она не была выделена вызовом функции LSA.
 

Для преобразования кода NTSTATUS в код ошибки Windows можно использовать функцию LsaNtStatusToWinError .

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header ntsecapi.h
Библиотека Advapi32.lib
DLL Advapi32.dll

См. также раздел

Возвращаемые значения функции политики LSA

LsaNtStatusToWinError