Metodo ChangeSecurityPermissions della classe CIM_DataFile

Il metodo ChangeSecurityPermissions modifica le autorizzazioni di sicurezza per il file di dati logico specificato nel percorso dell'oggetto. 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. Questo metodo viene ereditato da CIM_LogicalFile.

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 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 struttura SECURITY_DESCRIPTOR concede l'accesso illimitato. Per informazioni sulle implicazioni dell'accesso illimitato, vedere Creazione di un descrittore di sicurezza per un nuovo oggetto.

Opzione [in]

Privilegio di sicurezza da modificare. Ad esempio, per modificare il proprietario e la sicurezza DACL, usare:

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'ACL del file logico.

CHANGE_SACL_SECURITY_INFORMATION (8)

Modificare l'ACL 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. Per altri codici di errore, vedere Costanti di errore WMI o WbemErrorEnum. Per i valori HRESULT generali, vedere Codici di errore di sistema.

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

Piattaforma non NT/Windows 2000

12

Piattaforma non basata su Windows NT.

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

Il metodo ChangeSecurityPermissions in CIM_DataFile viene implementato da WMI.

Questa documentazione è derivata dalle descrizioni delle classi CIM pubblicate dal DMTF. Microsoft potrebbe aver apportato modifiche agli errori secondari corretti, essere 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	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

CIM_DataFile

CIM_DataFile

Attività WMI: file e cartelle

Costanti diritti di accesso a file e directory