Metodo ChangeSecurityPermissionsEx della classe Win32_ShortcutFile

Il metodo della classe ChangeSecurityPermissionsExWMI modifica le autorizzazioni di sicurezza per il file di collegamento logico 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 di controllo di accesso discrezionale (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 ExecMethod .

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 .

Nota

Per le istanze di file, il parametro Ricorsivo viene ignorato.

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 è il 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	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

Classi del sistema operativo

Win32_ShortcutFile