Metodo ChangeSecurityPermissions della classe Win32_ShortcutFile
Il metodo di classe WMIChangeSecurityPermissions modifica le autorizzazioni di sicurezza per il file di collegamento logico specificato nel percorso dell'oggetto. Se il file logico è una directory, ChangeSecurityPermissions è ricorsivo e modifica le autorizzazioni di sicurezza di tutti i file e le sottodirectory contenute nella directory. ChangeSecurityPermissions restituisce un valore intero pari a 0 (zero) se le autorizzazioni vengono modificate e un numero diverso per indicare un errore.
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]
-
Espressione che si risolve in un'istanza di Win32_SecurityDescriptor. Questo descrittore contiene nuove autorizzazioni di sicurezza per l'istanza di Win32_PageFile.
-
Opzione [in]
-
Privilegi di sicurezza effettivi 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 accesso discrezionale del file logico.
-
CHANGE_SACL_SECURITY_INFORMATION (8)
-
Modificare l'elenco di controllo di accesso del sistema (SACL) del file logico.
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 della condivisione
-
15
Esiste una violazione della 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 |
Radice\CIMV2 |
| MOF |
|
| DLL |
|