Funzione ObjectCloseAuditAlarmA (winbase.h)

Articolo
03/03/2024

La funzione ObjectCloseAuditAlarm genera un messaggio di controllo nel registro eventi di sicurezza quando viene eliminato un handle per un oggetto privato. Gli avvisi non sono attualmente supportati.

Sintassi

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

Parametri

[in] SubsystemName

Puntatore a una stringa con terminazione Null che specifica il nome del sottosistema che chiama la funzione. Questa stringa viene visualizzata in qualsiasi messaggio di controllo generato dalla funzione.

[in] HandleId

Valore univoco che rappresenta l'handle del client per l'oggetto . Deve essere lo stesso valore passato alla funzione AccessCheckAndAuditAlarm o ObjectOpenAuditAlarm .

[in] GenerateOnClose

Specifica un flag impostato da una chiamata alla funzione AccessCheckAndAuditAlarm o ObjectCloseAuditAlarm quando viene creato l'handle dell'oggetto. Se questo flag è TRUE, la funzione genera un messaggio di controllo. Se è FALSE, la funzione non genera un messaggio di controllo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione ObjectCloseAuditAlarm richiede che l'applicazione chiamante disponga del privilegio SE_AUDIT_NAME abilitato. Il test di questo privilegio viene sempre eseguito sul token primario del processo chiamante, consentendo al processo chiamante di rappresentare un client.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Advapi32.dll