Metodo ChangeSecurityPermissionsEx della classe CIM_DataFile

Articolo
06/12/2023

Il metodo ChangeSecurityPermissionsEx modifica le autorizzazioni di sicurezza per il file di dati logici specificato nel percorso dell'oggetto (questo metodo è una versione estesa del metodo ChangeSecurityPermissions ). Se il file logico è effettivamente una directory, questo metodo agisce in modo ricorsivo, modificando le autorizzazioni di sicurezza per tutti i file e le sotto directory che la directory contiene.

Importante

Le classi CIM (Distributed Management Task Force) (Common Information Model) di 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.

Questo argomento usa 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.

Nota

Un ACL NULL nella struttura SECURITY_DESCRIPTOR concede l'accesso illimitato. Per altre informazioni sulle implicazioni dell'accesso illimitato, vedere Creazione di un descrittore di sicurezza per un nuovo oggetto.

Opzione [in]

Privilegi di sicurezza da modificare. Ad esempio, per modificare il proprietario e la sicurezza daCL, usare:

Option = 1 + 4 o 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 controllo di accesso del file logico.

CHANGE_SACL_SECURITY_INFORMATION (8)

Modificare l'elenco di controllo di controllo 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 è Null se il metodo ha esito positivo.

StartFileName [in, facoltativo]

Stringa che rappresenta il file figlio (o la directory) da usare 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 del metodo precedente. Se questo parametro è Null, l'operazione viene eseguita nel file (o nella directory) specificata nella chiamata ExecMethod .

Se viene usato StartFileName, è necessario impostare anche su true.

Ricorsivo [in, facoltativo]

Se True, il metodo viene applicato in modo ricorsivo anche ai file e alle directory all'interno della directory specificata dall'istanza di CIM_DataFile . Per le istanze di file, questo parametro viene ignorato.

Valore restituito

Restituisce un valore pari a 0 (zero) sull'esito positivo e su 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

Esito positivo.

Accesso negato

Accesso negato.

Errore non specificato

Errore non specificato.

Oggetto non valido

Il nome dell'oggetto specificato non è valido.

L'oggetto esiste già

Oggetto già esistente.

File system non NTFS

File system non NTFS.

Piattaforma non NT/Windows 2000

Piattaforma non Windows.

Unità non uguale

Unità non uguale.

Directory non vuota

Directory non vuota.

Violazione della condivisione

Violazione di condivisione.

File di avvio non valido

Il file di avvio non è valido.

Privilegio non mantenuto

Privilegio non mantenuto.

Parametro non valido

Un parametro non è valido.

Commenti

Il metodo ChangeSecurityPermissionsEx in CIM_DataFile viene implementato da WMI.

Questa documentazione deriva dalle descrizioni della classe CIM pubblicate dal DMTF. Microsoft potrebbe aver apportato modifiche agli errori secondari corretti, 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	Radice\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

CIM_DataFile
CIM_DataFile
Attività WMI: file e cartelle
Costanti diritti di accesso file e directory

Condividi tramite