Función ObjectCloseAuditAlarmA (winbase.h)

Artículo
03/13/2024

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

Sintaxis

BOOL ObjectCloseAuditAlarmA(
  [in] LPCSTR 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 que el 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	winbase.h (incluya Windows.h)
Library	Advapi32.lib
Archivo DLL	Advapi32.dll