Funzione SetFileSecurityA (winbase.h)

Articolo
03/13/2024

La funzione SetFileSecurity imposta la sicurezza di un file o di un oggetto directory.

questa funzione è obsoleta. Usare invece la funzione SetNamedSecurityInfo .

Sintassi

BOOL SetFileSecurityA(
  [in] LPCSTR               lpFileName,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parametri

[in] lpFileName

Puntatore a una stringa con terminazione Null che specifica il file o la directory per cui è impostata la sicurezza. Si noti che la sicurezza applicata a una directory non viene ereditata dai relativi elementi figlio.

[in] SecurityInformation

Specifica una struttura SECURITY_INFORMATION che identifica il contenuto del descrittore di sicurezza a cui punta il parametro pSecurityDescriptor .

[in] pSecurityDescriptor

Puntatore a una struttura SECURITY_DESCRIPTOR .

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero.

Se la funzione ha esito negativo, restituisce zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione SetFileSecurity ha esito positivo solo se vengono soddisfatte le condizioni seguenti:

Se il proprietario dell'oggetto viene impostato, il processo chiamante deve disporre dell'autorizzazione WRITE_OWNER o essere il proprietario dell'oggetto.
Se viene impostato l'elenco di controllo di accesso discrezionale (DACL) dell'oggetto, il processo chiamante deve disporre dell'autorizzazione WRITE_DAC o essere il proprietario dell'oggetto.
Se è in corso l'impostazione dell'elenco di controllo di accesso di sistema (SACL) dell'oggetto, è necessario abilitare il privilegio SE_SECURITY_NAME per il processo chiamante.

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