Condividi tramite

Funzione SetFileSecurityW (securitybaseapi.h)

  • Articolo

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

questa funzione è obsoleta. Usare invece la funzione SetNamedSecurityInfo .

Sintassi

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

Vedi anche

GetFileSecurity
Controllo di accesso di basso livello
Funzioni di Controllo di accesso di basso livello
SECURITY_DESCRIPTOR
SECURITY_INFORMATION
SetKernelObjectSecurity
SetNamedSecurityInfoSetPrivateObjectSecuritySecurity
SetUserObjectSecurity