Condividi tramite


Funzione SetFileSecurityA (winbase.h)

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

Vedi anche

GetFileSecurity

Controllo di accesso di basso livello

Funzioni di Controllo di accesso di basso livello

SECURITY_DESCRIPTOR

SECURITY_INFORMATION

SetKernelObjectSecurity

SetNamedSecurityInfo

SetPrivateObjectSecurity

SetUserObjectSecurity