Поделиться через


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

Функция 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

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

AccessCheckAndAuditAlarm

Функции контроль доступа клиента или сервера

Общие сведения о клиенте и сервере контроль доступа

ObjectDeleteAuditAlarm

ObjectOpenAuditAlarm

ObjectPrivilegeAuditAlarm