Metodo ChangeSecurityPermissionsEx della classe Win32_Directory
Il metodo della classe ChangeSecurityPermissionsExWMI modifica le autorizzazioni di sicurezza per il file di immissione della directory specificato nel percorso dell'oggetto (questo metodo è una versione estesa del metodo ChangeSecurityPermissions ). Se il file logico è una directory, questo metodo è ricorsivo e modifica le autorizzazioni di sicurezza di tutti i file e le sottodirectory contenute nella directory.
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]
-
Espressione che viene risolta in un'istanza di Win32_SecurityDescriptor. Questo parametro contiene nuove autorizzazioni di sicurezza per l'istanza di Win32_PageFile.
-
Opzione [in]
-
Privilegio di sicurezza da modificare. Ad esempio, per modificare la sicurezza daCL (Owner and Discretionary Access Control List), usare quanto segue:
Option = 1 + 4-oppure-
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 DACL del file logico.
-
CHANGE_SACL_SECURITY_INFORMATION (8)
-
Modificare l'elenco di controllo di accesso di sistema (SACL) del file logico.
StopFileName [out]
Nome del file o della directory in cui il metodo ChangeSecurityPermissionsEx non è riuscito. Questo parametro è Null se il metodo ha esito positivo.
StartFileName [in, facoltativo]
Assegna un nome al file figlio o alla directory da usare come punto di partenza per ChangeSecurityPermissionsEx. 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 questo parametro è Null, l'operazione viene eseguita nel file o nella directory specificata nella chiamata a ExecMethod . Questo parametro è facoltativo e,
Se si usa StartFileName , è necessario impostare anche Recursive su true.
Ricorsiva [in, facoltativo]
Se true, la modifica della proprietà viene applicata in modo ricorsivo a file e directory all'interno della directory specificata dall'istanza di CIM_LogicalFile . Per le istanze di file, il parametro di input ricorsivo viene ignorato. Questo parametro è facoltativo e,
Valore restituito
Restituisce un valore pari a 0 (zero) se le autorizzazioni vengono modificate e un numero diverso per indicare un errore.
-
Success
-
0
La richiesta ha esito positivo.
-
Accesso negato
-
2
Accesso negato.
-
Errore non specificato
-
8
Si è verificato un errore non specificato.
-
Oggetto non valido
-
9
Il nome specificato non è valido.
-
L'oggetto esiste già
-
10
L'oggetto specificato esiste già.
-
File system non NTFS
-
11
Il file system non è un file system NTFS.
-
Piattaforma non NT/Windows 2000
-
12
La piattaforma non è Windows.
-
Unità non uguale
-
13
L'unità non è la stessa.
-
Directory non vuota
-
14
La directory non è vuota.
-
Violazione di condivisione
-
15
Esiste una violazione di condivisione.
-
File di avvio non valido
-
16
Il file di avvio specificato non è valido.
-
Privilegio non mantenuto
-
17
Non viene mantenuto un privilegio necessario per l'operazione.
-
Parametro non valido
-
21
Un parametro specificato non è valido.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Root\CIMV2 |
| MOF |
|
| DLL |
|