Funzione ObjectCloseAuditAlarmW (securitybaseapi.h)

  • Articolo

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 ObjectCloseAuditAlarmW(
  [in] LPCWSTR 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 securitybaseapi.h (include Windows.h)
Libreria Advapi32.lib
DLL Advapi32.dll

Vedi anche

AccessCheckAndAuditAlarm
Funzioni di Controllo di accesso client/server
Panoramica del Controllo di accesso client/server
ObjectDeleteAuditAlarm
ObjectOpenAuditAlarm
ObjectPrivilegeAuditAlarm