Metodo ChangeSecurityPermissions della classe CIM_LogicalFile
Il metodo ChangeSecurityPermissions modifica le autorizzazioni di sicurezza per il file logico specificato nel percorso dell'oggetto. Se il file logico è una directory, ChangeSecurityPermissions agisce in modo ricorsivo, modificando le autorizzazioni di sicurezza per tutti i file e le sotto directory contenute nella directory.
Importante
Le classi CIM (Distributed Management Task Force) (Common Information Model) di DMTF (Distributed Management Task Force) sono le classi padre su cui vengono compilate le classi WMI. WMI supporta attualmente solo gli schemi di versione CIM 2.x.
Questo argomento usa la sintassi MOF (Managed Object Format). Per altre informazioni sull'uso di questo metodo, vedere Chiamata di un metodo.
Sintassi
uint32 ChangeSecurityPermissions(
[in] Win32_SecurityDescriptor SecurityDescriptor,
[in] uint32 Option
);
Parametri
-
SecurityDescriptor [in]
-
Specifica le informazioni di sicurezza.
Nota
Un elenco di controllo di accesso NULL (ACL) nella SECURITY_DESCRIPTOR concede l'accesso illimitato.
-
Opzione [in]
-
Privilegi di sicurezza da modificare. Ad esempio, per modificare il proprietario e la sicurezza daCL, usare:
Option = 1 + 4oppure
Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION -
Change_Owner_Security_Information (1)
-
Modificare il proprietario del file logico.
-
Change_Group_Security_Information (2)
-
Modificare il gruppo del file logico.
-
Change_Dacl_Security_Information (4)
-
Modificare l'elenco di controllo di controllo di accesso del file logico.
-
Change_Sacl_Security_Information (8)
-
Modificare l'elenco di controllo di controllo di sistema del file logico.
Valore restituito
Restituisce un valore pari a 0 in caso di esito positivo e qualsiasi altro numero per indicare un errore.
-
Success
-
0
Esito positivo.
-
Accesso negato
-
2
Accesso negato.
-
Errore non specificato
-
8
Errore non specificato.
-
Oggetto non valido
-
9
Oggetto non valido.
-
L'oggetto esiste già
-
10
Oggetto già esistente.
-
File system non NTFS
-
11
File system non NTFS.
-
Piattaforma non NT/Windows 2000
-
12
Piattaforma non Windows.
-
Unità non uguale
-
13
Unità non uguale.
-
Directory non vuota
-
14
Directory non vuota.
-
Violazione della condivisione
-
15
Violazione di condivisione.
-
File di avvio non valido
-
16
File di avvio non valido.
-
Privilegio non mantenuto
-
17
Privilegio non mantenuto.
-
Parametro non valido
-
21
Parametro non valido.
Commenti
Questo metodo non è attualmente implementato da WMI. Per usare questo metodo, è necessario implementarlo nel proprio provider.
Questa documentazione deriva dalle descrizioni della classe CIM pubblicate dal DMTF. Microsoft potrebbe aver apportato modifiche agli errori secondari corretti, conformi agli standard della documentazione di Microsoft SDK o fornire altre informazioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Radice\CIMV2 |
| MOF |
|
| DLL |
|