Función ObjectCloseAuditAlarmW (securitybaseapi.h)

La función ObjectCloseAuditAlarm genera un mensaje de auditoría en el registro de eventos de seguridad cuando se elimina un identificador de un objeto privado. Actualmente no se admiten alarmas.

Sintaxis

BOOL ObjectCloseAuditAlarmW(
  [in] LPCWSTR SubsystemName,
  [in] LPVOID  HandleId,
  [in] BOOL    GenerateOnClose
);

Parámetros

[in] SubsystemName

Puntero a una cadena terminada en null que especifica el nombre del subsistema que llama a la función. Esta cadena aparece en cualquier mensaje de auditoría que genere la función.

[in] HandleId

Valor único que representa el identificador del cliente para el objeto . Debe ser el mismo valor que se pasó a la función AccessCheckAndAuditAlarm o ObjectOpenAuditAlarm .

[in] GenerateOnClose

Especifica una marca establecida por una llamada a la función AccessCheckAndAuditAlarm o ObjectCloseAuditAlarm cuando se crea el identificador de objeto. Si esta marca es TRUE, la función genera un mensaje de auditoría. Si es FALSE, la función no genera un mensaje de auditoría.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función ObjectCloseAuditAlarm requiere que la aplicación que llama tenga habilitado el privilegio SE_AUDIT_NAME. La prueba de este privilegio siempre se realiza en el token principal del proceso de llamada, lo que permite al proceso de llamada suplantar a un cliente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	securitybaseapi.h (incluya Windows.h)
Library	Advapi32.lib
Archivo DLL	Advapi32.dll

Consulte también

AccessCheckAndAuditAlarm
Funciones de Access Control cliente/servidor
Introducción a la Access Control de cliente/servidor
ObjectDeleteAuditAlarm
ObjectOpenAuditAlarm
ObjectPrivilegeAuditAlarm