CIM_LogicalFile class

The CIM_LogicalFile class represents a named collection of data, which can be executable code, that is located in a file system on a storage extent.

Important  The DMTF (Distributed Management Task Force) CIM (Common Information Model) classes are the parent classes upon which WMI classes are built. WMI currently supports only the CIM 2.x version schemas.
 

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

[SupportsDelete, DeleteBy("DeleteInstance"), Abstract, Provider("CIMWin32"), UUID("{8502C559-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("Files (CIM)"), AMENDMENT]
class CIM_LogicalFile : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  uint32   AccessMask;
  boolean  Archive;
  boolean  Compressed;
  string   CompressionMethod;
  string   CreationClassName;
  datetime CreationDate;
  string   CSCreationClassName;
  string   CSName;
  string   Drive;
  string   EightDotThreeFileName;
  boolean  Encrypted;
  string   EncryptionMethod;
  string   Name;
  string   Extension;
  string   FileName;
  uint64   FileSize;
  string   FileType;
  string   FSCreationClassName;
  string   FSName;
  boolean  Hidden;
  uint64   InUseCount;
  datetime LastAccessed;
  datetime LastModified;
  string   Path;
  boolean  Readable;
  boolean  System;
  boolean  Writeable;
};

Members

The CIM_LogicalFile class has these types of members:

Methods

The CIM_LogicalFile class has these methods.

MethodDescription
ChangeSecurityPermissions

Changes the security permissions for the logical file specified in the object path. Not implemented by WMI.

ChangeSecurityPermissionsEx

Changes the security permissions for the logical file specified in the object path. Not implemented by WMI.

Compress

Compresses the logical file (or directory) specified in the object path. Not implemented by WMI.

CompressEx

Compresses the logical file (or directory) specified in the object path. Not implemented by WMI.

Copy

Copies the logical file (or directory) specified in the object path to the location specified by the input parameter. Not implemented by WMI.

CopyEx

Copies the logical file (or directory) specified in the object path to the location specified by the input parameter. Not implemented by WMI.

Delete

Deletes the logical file (or directory) specified in the object path. Not implemented by WMI.

DeleteEx

Deletes the logical file (or directory) specified in the object path. Not implemented by WMI.

GetEffectivePermission

Determines whether the caller has the aggregated permissions specified by the Permission argument. Not implemented by WMI.

Rename

Renames the logical file (or directory) specified in the object path. Not implemented by WMI.

TakeOwnerShip

Obtains ownership of the logical file (or directory) specified in the object path. Not implemented by WMI.

TakeOwnerShipEx

Obtains ownership of the logical file (or directory) specified in the object path. Not implemented by WMI.

Uncompress

Uncompresses the logical file (or directory) specified in the object path. Not implemented by WMI.

UncompressEx

Uncompresses the logical file (or directory) specified in the object path. Not implemented by WMI.

 

Properties

The CIM_LogicalFile class has these properties.

AccessMask
Data type: uint32
Access type: Read-only
Qualifiers: Schema ("Win32"), DisplayName ("Access Rights")

Bitmask that represents the access rights required to access or perform specific operations on the file. For bit values, see File and Directory Access Rights Constants.

Note  On FAT volumes, the FULL_ACCESS value is returned instead, which indicates no security has been set on the object.
 

FILE_READ_DATA (file) or FILE_LIST_DIRECTORY (directory) (1)

FILE_WRITE_DATA (file) or FILE_ADD_FILE (directory) (2)

FILE_APPEND_DATA (file) or FILE_ADD_SUBDIRECTORY (directory) (4)

FILE_READ_EA (8)

FILE_WRITE_EA (16)

FILE_EXECUTE (file) or FILE_TRAVERSE (directory) (32)

FILE_DELETE_CHILD (directory) (64)

FILE_READ_ATTRIBUTES (128)

FILE_WRITE_ATTRIBUTES (256)

DELETE (65536)

READ_CONTROL (131072)

WRITE_DAC (262144)

WRITE_OWNER (524288)

SYNCHRONIZE (1048576)

Archive
Data type: boolean
Access type: Read-only
Qualifiers: Schema ("Win32"), DisplayName ("Should Be Archived")

If True, the file should be archived.

Caption
Data type: string
Access type: Read-only
Qualifiers: MaxLen (64), DisplayName ("Caption")

A short textual description of the object.

This property is inherited from CIM_ManagedSystemElement.

Compressed
Data type: boolean
Access type: Read-only
Qualifiers: Schema ("Win32"), DisplayName ("Compressed")

If True, the file is compressed.

CompressionMethod
Data type: string
Access type: Read-only
Qualifiers: DisplayName ("Compression Method")

Free-form string that indicates the algorithm or tool used to compress the logical file. If the compression scheme is unknown or not described, use "Unknown". If the logical file is compressed, but the compression scheme is unknown or not described, use "Compressed". If the logical file is not compressed, use "Not Compressed".

CreationClassName
Data type: string
Access type: Read-only
Qualifiers: CIM_Key, DisplayName ("Class Name")

Name of the class.

CreationDate
Data type: datetime
Access type: Read-only
Qualifiers: DisplayName ("Creation Date")

Date and time of the file's creation.

CSCreationClassName
Data type: string
Access type: Read-only
Qualifiers: Propagated ("CIM_FileSystem.CSCreationClassName"), CIM_Key, DisplayName ("Computer System Class Name")

Class of the computer system.

CSName
Data type: string
Access type: Read-only
Qualifiers: Propagated ("CIM_FileSystem.CSName"), CIM_Key, DisplayName ("Computer System Name")

Name of the computer system.

Description
Data type: string
Access type: Read-only
Qualifiers: DisplayName ("Description")

A textual description of the object.

This property is inherited from CIM_ManagedSystemElement.

Drive
Data type: string
Access type: Read-only
Qualifiers: Fixed, Schema ("Win32"), DisplayName ("Drive")

Drive letter (including the colon that follows the drive letter) of the file. This property is inherited from CIM_LogicalFile.Example: "c:"

EightDotThreeFileName
Data type: string
Access type: Read-only
Qualifiers: Schema ("Win32"), DisplayName ("Eight Dot Three File Name")

DOS-compatible file name. Example: "c:\progra~1"

Encrypted
Data type: boolean
Access type: Read-only
Qualifiers: Schema ("Win32"), DisplayName ("Encrypted")

If True, the file is encrypted.

EncryptionMethod
Data type: string
Access type: Read-only
Qualifiers: DisplayName ("Encryption Method")

Free-form string that identifies the algorithm or tool used to encrypt a logical file. If the encryption scheme is not indulged (for security reasons, for example), use "Unknown". If the file is encrypted, but either its encryption scheme is unknown or not disclosed, use "Encrypted". If the logical file is not encrypted, use "Not Encrypted".

Extension
Data type: string
Access type: Read-only
Qualifiers: Fixed, Schema ("Win32"), DisplayName ("File Extension")

File name extension without the preceding period (dot). Example: "txt", "mof", "mdb"

FileName
Data type: string
Access type: Read-only
Qualifiers: Fixed, Schema ("Win32"), DisplayName ("File Name")

File name without the file name extension. Example: "MyDataFile"

FileSize
Data type: uint64
Access type: Read-only
Qualifiers: DisplayName ("Size"), Units ("bytes")

Size of the file, in bytes.

For more information about using uint64 values in scripts, see Scripting in WMI.

FileType
Data type: string
Access type: Read-only
Qualifiers: Schema ("Win32"), DisplayName ("File Type")

Descriptor that represents the file type indicated by the Extension property.

FSCreationClassName
Data type: string
Access type: Read-only
Qualifiers: Propagated ("CIM_FileSystem.CreationClassName"), CIM_Key, DisplayName ("File System Class Name")

Class of the file system.

FSName
Data type: string
Access type: Read-only
Qualifiers: Propagated ("CIM_FileSystem.Name"), CIM_Key, DisplayName ("File System Name")

Name of the file system.

Hidden
Data type: boolean
Access type: Read-only
Qualifiers: Schema ("Win32"), DisplayName ("Hidden")

If True, the file is hidden.

InstallDate
Data type: datetime
Access type: Read-only
Qualifiers: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("Install Date")

Indicates when the object was installed. Lack of a value does not indicate that the object is not installed.

This property is inherited from CIM_ManagedSystemElement.

InUseCount
Data type: uint64
Access type: Read-only
Qualifiers: DisplayName ("Current File Open Count")

Number of "file opens" that are currently active against the file.

For more information about using uint64 values in scripts, see Scripting in WMI.

LastAccessed
Data type: datetime
Access type: Read-only
Qualifiers: DisplayName ("Last Accessed")

Date and time the file was last accessed.

LastModified
Data type: datetime
Access type: Read-only
Qualifiers: DisplayName ("Last Modified")

Date and time the file was last modified.

Name
Data type: string
Access type: Read-only
Qualifiers: Override ("Name"), Key

The Name property is a string representing the inherited name that serves as a key of a logical file instance within a file system. Full path names should be provided. Example: C:\Windows\system\win.ini

Path
Data type: string
Access type: Read-only
Qualifiers: Fixed, Schema ("Win32"), DisplayName ("Path")

Path of the file including the leading and trailing backslashes. Example: "\windows\system\"

Readable
Data type: boolean
Access type: Read-only
Qualifiers: DisplayName ("Readable")

If True, the file can be read.

Status
Data type: string
Access type: Read-only
Qualifiers: MaxLen (10), DisplayName ("Status")

String that indicates the current status of the object. Operational and non-operational status can be defined. Operational status can include "OK", "Degraded", and "Pred Fail". "Pred Fail" indicates that an element is functioning properly, but is predicting a failure (for example, a SMART-enabled hard disk drive).

Non-operational status can include "Error", "Starting", "Stopping", and "Service". "Service" can apply during disk mirror-resilvering, reloading a user permissions list, or other administrative work. Not all such work is online, but the managed element is neither "OK" nor in one of the other states.

This property is inherited from CIM_ManagedSystemElement.

Values include the following:

OK ("OK")

Error ("Error")

Degraded ("Degraded")

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Starting ("Starting")

Stopping ("Stopping")

Service ("Service")

Stressed ("Stressed")

NonRecover ("NonRecover")

No Contact ("No Contact")

Lost Comm ("Lost Comm")

System
Data type: boolean
Access type: Read-only
Qualifiers: Schema ("Win32"), DisplayName ("System File")

If True, the file is a system file.

Writeable
Data type: boolean
Access type: Read-only
Qualifiers: DisplayName ("Writeable")

If True, the file can be written.

Remarks

The CIM_LogicalFile class is derived from CIM_LogicalElement.

WMI does not implement this class. For classes derived from CIM_LogicalFile, see Win32 Classes.

This documentation is derived from the CIM class descriptions published by the DMTF. Microsoft may have made changes to correct minor errors, conform to Microsoft SDK documentation standards, or provide more information.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Namespace

Root\CIMV2

MOF

CIMWin32.mof

DLL

CIMWin32.dll

See also

CIM_LogicalElement

 

 

Show: