Функция ObjectCloseAuditAlarmA (winbase.h)

Статья
03/03/2024

Функция ObjectCloseAuditAlarm создает сообщение аудита в журнале событий безопасности при удалении дескриптора частного объекта. Будильники в настоящее время не поддерживаются.

Синтаксис

BOOL ObjectCloseAuditAlarmA(
  [in] LPCSTR SubsystemName,
  [in] LPVOID HandleId,
  [in] BOOL   GenerateOnClose
);

Параметры

[in] SubsystemName

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

[in] HandleId

Уникальное значение, представляющее дескриптор клиента для объекта . Это должно быть то же значение, которое было передано функции AccessCheckAndAuditAlarm или ObjectOpenAuditAlarm .

[in] GenerateOnClose

Задает флаг, заданный вызовом функции AccessCheckAndAuditAlarm или ObjectCloseAuditAlarm при создании дескриптора объекта. Если этот флаг имеет значение TRUE, функция создает сообщение аудита. Если оно имеет значение FALSE, функция не создает сообщение аудита.

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

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

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

Для функции ObjectCloseAuditAlarm требуется, чтобы вызывающее приложение было включено разрешение SE_AUDIT_NAME. Проверка этой привилегии всегда выполняется для основного маркера вызывающего процесса, что позволяет вызывающему процессу олицетворять клиента.

Требования

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