Metodo ChangeSecurityPermissionsEx della classe CIM_LogicalFile
Il metodo ChangeSecurityPermissionsEx modifica le autorizzazioni di sicurezza per il file logico specificato nel percorso dell'oggetto (questo metodo è una versione estesa del metodo ChangeSecurityPermissions ). Se il file logico è una directory, questo metodo agisce in modo ricorsivo, modificando le autorizzazioni di sicurezza per tutti i file e le sottodirectory contenute nella directory.
Importante
Le classi CIM (Distributed Management Task Force) (Common Information Model) 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.
In questo argomento viene utilizzata la sintassi MOF (Managed Object Format). Per altre informazioni sull'uso di questo metodo, vedere Chiamata di un metodo.
Sintassi
uint32 ChangeSecurityPermissionsEx(
[in] Win32_SecurityDescriptor SecurityDescriptor,
[in] uint32 Option,
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
Parametri
-
SecurityDescriptor [in]
-
Specifica le informazioni di sicurezza.
-
Opzione [in]
-
Privilegio 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'ACL del file logico.
-
Change_Sacl_Security_Information (8)
-
Modificare l'ACL di sistema del file logico.
StopFileName [out]
Stringa che rappresenta il nome del file (o della directory) in cui il metodo non è riuscito. Questo parametro ha un valore Null se il metodo ha esito positivo.
StartFileName [in, facoltativo]
Stringa che rappresenta il file figlio (o la directory) da utilizzare come punto di partenza per questo metodo. In genere, il parametro StartFileName è il parametro StopFileName che specifica il file (o la directory) in cui si è verificato un errore dalla chiamata al metodo precedente. Se il valore del parametro è Null, l'operazione viene eseguita nel file o nella directory specificata nella chiamata a ExecMethod .
Ricorsiva [in, facoltativo]
Se TRUE, le autorizzazioni di sicurezza vengono applicate in modo ricorsivo a file e directory all'interno della directory specificata dall'istanza di CIM_LogicalFile . Per le istanze di file, questo parametro viene ignorato.
Valore restituito
Restituisce un valore pari a 0 (zero) sull'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
L'unità non è la stessa.
-
Directory non vuota
-
14
Directory non vuota.
-
Violazione di 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Root\CIMV2 |
| MOF |
|
| DLL |
|