Freigeben über


CIM_DeviceFile-Klasse

Die CIM_DeviceFile-Klasse stellt einen Typ der logischen Datei dar, der ein Gerät darstellt. Diese Konvention ist nützlich für Betriebssysteme, die Geräte mit einem Bytestream-E/A-Modell verwalten. Das logische Gerät, das dieser Datei zugeordnet ist, wird mithilfe der CIM_DeviceAccessedByFile Beziehung angegeben.

Wichtig

Die CIM-Klassen (Common Information Model) von DMTF (Distributed Management Task Force) sind die übergeordneten Klassen, auf denen WMI-Klassen erstellt werden. WMI unterstützt derzeit nur die CIM 2.x-Versionsschemas.

Die folgende Syntax wird durch MOF-Code (Managed Object Format) vereinfacht und schließt alle geerbten Eigenschaften ein. Eigenschaften werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge aufgeführt.

Syntax

[Abstract, UUID("{4333BD60-E3D1-11d2-8601-0000F8102E5F}"), AMENDMENT]
class CIM_DeviceFile : CIM_LogicalFile
{
  uint32   AccessMask;
  boolean  Archive;
  string   Caption;
  boolean  Compressed;
  string   CompressionMethod;
  string   CreationClassName;
  datetime CreationDate;
  string   CSCreationClassName;
  string   CSName;
  string   Description;
  string   Drive;
  string   EightDotThreeFileName;
  boolean  Encrypted;
  string   EncryptionMethod;
  string   Extension;
  string   FileName;
  uint64   FileSize;
  string   FileType;
  string   FSCreationClassName;
  string   FSName;
  boolean  Hidden;
  datetime InstallDate;
  uint64   InUseCount;
  datetime LastAccessed;
  datetime LastModified;
  string   Name;
  string   Path;
  boolean  Readable;
  string   Status;
  boolean  System;
  boolean  Writeable;
};

Member

Die CIM_DeviceFile-Klasse verfügt über folgende Membertypen:

Methoden

Die CIM_DeviceFile-Klasse verfügt über diese Methoden.

Methode Beschreibung
ChangeSecurityPermissions Ändert die Sicherheitsberechtigungen für die im Objektpfad angegebene logische Datei. Nicht von WMI implementiert.
ChangeSecurityPermissionsEx Ändert die Sicherheitsberechtigungen für die im Objektpfad angegebene logische Datei. Nicht von WMI implementiert.
Komprimieren Komprimiert die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Nicht von WMI implementiert.
CompressEx Komprimiert die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Nicht von WMI implementiert.
Kopieren Kopiert die im Objektpfad angegebene logische Datei (oder das Verzeichnis) an den durch den Eingabeparameter angegebenen Speicherort. Nicht von WMI implementiert.
CopyEx Kopiert die im Objektpfad angegebene logische Datei (oder das Verzeichnis) an den durch den Eingabeparameter angegebenen Speicherort. Nicht von WMI implementiert.
Löschen Löscht die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Nicht von WMI implementiert.
DeleteEx Löscht die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Nicht von WMI implementiert.
GetEffectivePermission Bestimmt, ob der Aufrufer über die durch das Permission-Argument angegebenen aggregierten Berechtigungen verfügt. Nicht von WMI implementiert.
Umbenennen Benennt die im Objektpfad angegebene logische Datei (oder das Verzeichnis) um. Nicht von WMI implementiert.
TakeOwnerShip Ruft den Besitz der logischen Datei ab, die im Objektpfad angegeben ist. Nicht von WMI implementiert.
TakeOwnerShipEx Ruft den Besitz der logischen Datei ab, die im Objektpfad angegeben ist. Nicht von WMI implementiert.
Dekomprimieren Entpackt die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Nicht von WMI implementiert.
UncompressEx Entpackt die logische Datei (oder das Verzeichnis), die im Objektpfad angegeben ist. Nicht von WMI implementiert.

Eigenschaften

Die CIM_DeviceFile-Klasse verfügt über diese Eigenschaften.

Accessmask

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32"), DisplayName ("Zugriffsrechte")

Bitarray, das die Zugriffsrechte für die angegebene Datei oder das angegebene Verzeichnis darstellt, die von dem Benutzer oder der Gruppe verwaltet wird, in deren Namen die instance zurückgegeben wird. Auf FAT-Volumes wird FULL_ACCESS zurückgegeben, was angibt, dass keine Sicherheit für das Objekt festgelegt wurde.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

FILE_READ_DATA (Datei) oder FILE_LIST_DIRECTORY (Verzeichnis) (1)

Gewährt das Recht, Daten aus der Datei zu lesen. Für ein Verzeichnis gewährt dieser Wert das Recht, den Inhalt des Verzeichnisses auflisten zu können.

FILE_WRITE_DATA (Datei) oder FILE_ADD_FILE (Verzeichnis) (2)

Gewährt das Recht, Daten in die Datei zu schreiben. Für ein Verzeichnis gewährt dieser Wert das Recht, eine Datei im Verzeichnis zu erstellen.

FILE_APPEND_DATA (Datei) oder FILE_ADD_SUBDIRECTORY (Verzeichnis) (4)

Gewährt das Recht, Daten an die Datei anzufügen. Für ein Verzeichnis gewährt dieser Wert das Recht, ein Unterverzeichnis zu erstellen.

FILE_READ_EA (8)

Gewährt das Recht, erweiterte Attribute zu lesen.

FILE_WRITE_EA (16)

Gewährt das Recht, erweiterte Attribute zu schreiben.

FILE_EXECUTE (Datei) oder FILE_TRAVERSE (Verzeichnis) (32)

Gewährt das Recht, eine Datei auszuführen. Für ein Verzeichnis kann das Verzeichnis durchlaufen werden.

FILE_DELETE_CHILD (Verzeichnis) (64)

Gewährt das Recht, ein Verzeichnis und alle darin enthaltenen Dateien (seine untergeordneten Elemente) zu löschen, auch wenn die Dateien schreibgeschützt sind.

FILE_READ_ATTRIBUTES (128)

Gewährt das Recht zum Lesen von Dateiattributen.

FILE_WRITE_ATTRIBUTES (256)

Gewährt das Recht, Dateiattribute zu ändern.

DELETE (65536)

Gewährt Löschzugriff.

READ_CONTROL (131072)

Gewährt lesezugriff auf den Sicherheitsdeskriptor und den Besitzer.

WRITE_DAC (262144)

Gewährt Schreibzugriff auf die ermessensbezogene ACL.

WRITE_OWNER (524288)

Weist den Schreibbesitzer zu.

SYNCHRONIZE (1048576)

Synchronisiert den Zugriff und ermöglicht es einem Prozess, darauf zu warten, dass ein Objekt in den signalierten Zustand wechselt.

Archivieren

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32"), DisplayName ("Sollte archiviert werden")

True gibt an, dass die Datei archiviert werden soll.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64), DisplayName ("Caption")

Kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Compressed

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32"), DisplayName ("Compressed")

True gibt an, dass die Datei komprimiert wird.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

CompressionMethod

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Compression Method")

Freiformzeichenfolge, die den Algorithmus oder das Tool zum Komprimieren der logischen Datei angibt. Wenn das Komprimierungsschema unbekannt oder nicht beschrieben ist, verwenden Sie "Unbekannt". Wenn die logische Datei komprimiert ist, das Komprimierungsschema jedoch unbekannt oder nicht beschrieben ist, verwenden Sie "Komprimiert". Wenn die logische Datei nicht komprimiert ist, verwenden Sie "Nicht komprimiert".

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

CreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: CIM_Key, DisplayName ("Klassenname")

Name der Klasse.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

CreationDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Erstellungsdatum")

Erstellungsdatum der Datei.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

CSCreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Propagiert ("CIM_FileSystem. CSCreationClassName"), CIM_Key, DisplayName ("Computer System Class Name")

Klasse des Computersystems.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

CSName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Propagiert ("CIM_FileSystem. CSName"), CIM_Key, DisplayName ("Computersystemname")

Name des Computersystems.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Description")

Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Laufwerk

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Behoben, Schema ("Win32"), DisplayName ("Drive")

Laufwerkbuchstabe (einschließlich des Doppelpunkts, der auf den Laufwerkbuchstaben folgt) der Datei. Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Beispiel: "c:"

EightDotThreeFileName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32"), DisplayName ("Eight Dot Three File Name")

DOS-kompatibler Dateiname für die Datei. Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Beispiel: "c:\progra~1"

Verschlüsselt

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32"), DisplayName ("Encrypted")

True gibt an, dass die Datei verschlüsselt ist.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Encryptionmethod

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Encryption Method")

Freiformzeichenfolge, die den Algorithmus oder das Tool zum Verschlüsseln einer logischen Datei identifiziert. Wenn das Verschlüsselungsschema nicht verwendet wird (z. B. aus Sicherheitsgründen), verwenden Sie "Unbekannt". Wenn die Datei verschlüsselt ist, aber entweder ihr Verschlüsselungsschema unbekannt oder nicht offengelegt ist, verwenden Sie "Encrypted". Wenn die logische Datei nicht verschlüsselt ist, verwenden Sie "Not Encrypted".

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Erweiterung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Behoben, Schema ("Win32"), DisplayName ("Dateierweiterung")

Dateinamenerweiterung ohne den vorherigen Punkt (Punkt).

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Beispiel: "txt", "mof", "mdb"

FileName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Behoben, Schema ("Win32"), DisplayName ("Dateiname")

Dateiname ohne Dateinamenerweiterung.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Beispiel: "MyDataFile"

FileSize

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Size"), Units ("bytes")

Größe der Datei in Bytes.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.

FileType

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32"), DisplayName ("Dateityp")

Deskriptor, der den Dateityp darstellt (durch die Extension-Eigenschaft angegeben).

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

FSCreationClassName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Weitergegeben ("CIM_FileSystem. CreationClassName"), CIM_Key, DisplayName ("Dateisystemklassenname")

Klasse des Dateisystems.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

FSName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Weitergegeben ("CIM_FileSystem. Name"), CIM_Key, DisplayName ("Dateisystemname")

Name des Dateisystems.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Hidden

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32"), DisplayName ("Hidden")

Bei True ist die Datei ausgeblendet.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Installationsdatum")

Datum und Uhrzeit der Installation des Objekts. Diese Eigenschaft benötigt keinen Wert, um anzugeben, dass das Objekt installiert ist.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

InUseCount

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Current File Open Count")

Anzahl der "Datei öffnet", die derzeit für die Datei aktiv sind.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.

LastAccessed

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Letzter Zugriff")

Datum und Uhrzeit des letzten Zugriffs auf die Datei.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Lastmodified

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Last Modified")

Datum und Uhrzeit der letzten Änderung der Datei.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Name

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

Geerbter Name, der als Schlüssel einer logischen Datei instance innerhalb eines Dateisystems dient (vollständige Pfadnamen bereitstellen).

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Beispiel: "C:\Windows\system\win.ini"

Pfad

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Behoben, Schema ("Win32"), DisplayName ("Pfad")

Pfad der Datei, einschließlich führender und nachgestellter umgekehrter Schrägstriche. Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Beispiel: "\windows\system\"

Lesbar

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("lesbar")

Wenn True, kann die Datei gelesen werden.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Status

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (10), DisplayName ("Status")

Zeichenfolge, die den aktuellen status des Objekts angibt. Es können operative und nicht operative status definiert werden. Operative status können "OK", "Degraded" und "Pred Fail" enthalten. "Pred Fail" gibt an, dass ein Element ordnungsgemäß funktioniert, aber einen Fehler vorhersagt (z. B. ein SMART-fähiges Festplattenlaufwerk).

Nicht-operationale status können "Error", "Starting", "Stop" und "Service" enthalten. "Dienst" kann beim Spiegel des Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen Administrativen Arbeiten angewendet werden. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Degraded ("Degraded")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Starten ("Start")

Beenden ("Beenden")

Dienst ("Dienst")

Gestresst ("Gestresst")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

System

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schema ("Win32"), DisplayName ("Systemdatei")

Bei True handelt es sich bei der Datei um eine Systemdatei.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Schreibbar

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Writeable")

True gibt an, dass die Datei geschrieben werden kann.

Diese Eigenschaft wird von CIM_LogicalFile geerbt.

Bemerkungen

Die CIM_DeviceFile-Klasse wird von CIM_LogicalFile abgeleitet.

WMI implementiert diese Klasse nicht.

Diese Dokumentation wird von den CIM-Klassenbeschreibungen abgeleitet, die von der DMTF veröffentlicht werden. Microsoft hat möglicherweise Änderungen vorgenommen, um kleinere Fehler zu korrigieren, den Microsoft SDK-Dokumentationsstandards zu entsprechen oder weitere Informationen bereitzustellen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
WindowsServer 2008
Namespace
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Siehe auch

CIM_LogicalFile