CIM_FileSpecification class

The CIM_FileSpecification class represents a file that is either on or off of the system. The file is located in the directory identified by the CIM_DirectorySpecificationFile association. The Invoke method uses the information to check for the file's existence. Note that properties with a Null value are not checked.

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

[UUID("{41F377B0-DB2A-11d2-85FC-0000F8102E5F}"), abstract, AMENDMENT]
class CIM_FileSpecification : CIM_Check
{
  string   CheckID;
  string   Caption;
  string   Description;
  boolean  CheckMode;
  uint16   TargetOperatingSystem;
  string   Version;
  string   SoftwareElementID;
  uint16   SoftwareElementState;
  string   Name;
  uint32   CheckSum;
  uint32   CRC1;
  uint32   CRC2;
  datetime CreateTimeStamp;
  uint64   FileSize;
  string   MD5Checksum;
};

Members

The CIM_FileSpecification class has these types of members:

Methods

The CIM_FileSpecification class has these methods.

MethodDescription
Invoke

Evaluates a particular check. Not implemented by WMI.

 

Properties

The CIM_FileSpecification class has these properties.

Caption
Data type: string
Access type: Read-only
Qualifiers: Maxlen (64)

A short textual description of the subject.

This property is inherited from CIM_Check.

CheckID
Data type: string
Access type: Read-only
Qualifiers: key, maxlen (256)

Identifier used in conjunction with other keys to uniquely identify the check.

This property is inherited from CIM_Check.

CheckMode
Data type: boolean
Access type: Read-only

If TRUE, the condition is expected to exist in the environment. For example, a file is expected to be on a system, so the Invoke method should return TRUE.

If FALSE, the condition is not expected to exist. For example, a file is not on a system, so the Invoke method should return FALSE.

This property is inherited from CIM_Check.

CheckSum
Data type: uint32
Access type: Read-only
Qualifiers: Mappingstrings ("MIF.DMTF|Software Signature|002.4")

Value calculated as the 16-bit sum of the file's first 32 bytes.

CRC1
Data type: uint32
Access type: Read-only
Qualifiers: Mappingstrings ("MIF.DMTF|Software Signature|002.5")

CRC value calculated using the middle 512 KB.

CRC2
Data type: uint32
Access type: Read-only
Qualifiers: Mappingstrings ("MIF.DMTF|Software Signature|002.6")

CRC value for the middle 512 KB of the file, modulo 3.

CreateTimeStamp
Data type: datetime
Access type: Read-only
Qualifiers: Fixed

File creation date and time.

Description
Data type: string
Access type: Read-only

A description of the objects.

This property is inherited from CIM_Check.

FileSize
Data type: uint64
Access type: Read-only
Qualifiers: units ("kilobytes")

Size of the file, in bytes.

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

MD5Checksum
Data type: string
Access type: Read-only
Qualifiers: maxlen (16)

Algorithm for computing a 128-bit checksum for any file or object. The likelihood of two different files producing the same MD5 checksum is very small (about 1 in 2^64), and the MD5 checksum of a file can be used to construct a reliable content identifier that is likely to uniquely identify the file. The reverse is also true. If two files have the same MD5 checksum, it is very likely that the files are identical. For purposes of MOF specification of the MD5 property, the MD5 algorithm always generates a 32-character string. For example, the string "abcdefghijklmnopqrstuvwxyz" generates the string "c3fcd3d76192e4007dfb496cca67e13b". For more information about implementing the MD5 algorithm, see RFC 1321.

Name
Data type: string
Access type: Read-only
Qualifiers: Override (Name), Fixed, maxlen (1024)

Either the name of the file or the name of the file with a directory prefix.

SoftwareElementID
Data type: string
Access type: Read-only
Qualifiers: Propagated ("CIM_SoftwareElement.SoftwareElementID"), CIM_key, maxlen (256)

This is an identifier for this software element.

This property is inherited from CIM_Check.

SoftwareElementState
Data type: uint16
Access type: Read-only
Qualifiers: Propagated ("CIM_SoftwareElement.SoftwareElementState"), CIM_key

The software element state of a software element.

This property is inherited from CIM_Check.

Deployable (0)

Describes the details necessary for successful distribution and the details (conditions and actions) required to create a software element in the installable state (that is, the next state).

Installable (1)

Describes the details necessary for successful installation and the details (conditions and actions) required to create a software element in the executable state (that is, the next state).

Executable (2)

Describes the details necessary for successful execution and the details (conditions and actions) required to create a software element in the running state (that is, the next state).

Running (3)

Describes the details necessary to monitor and operate on a start element.

TargetOperatingSystem
Data type: uint16
Access type: Read-only
Qualifiers: Propagated ("CIM_SoftwareElement.TargetOperatingSystem"), CIM_key, Mappingstrings ("MIF.DMTF|Software Component Information|002.5")

Target operating system of the software element.

This property is inherited from CIM_Check.

Unknown (0)

Other (1)

MACOS (2)

Mac OS

ATTUNIX (3)

ATT UNIX

DGUX (4)

DECNT (5)

Digital Unix (6)

OpenVMS (7)

Open VMS

HPUX (8)

HP-UX

AIX (9)

MVS (10)

OS400 (11)

OS/2 (12)

JavaVM (13)

Microsoft Virtual Machine (VM) for Java

MSDOS (14)

WIN3x (15)

Windows 3.x

WIN95 (16)

Windows 95

WIN98 (17)

Windows 98

WINNT (18)

Windows NT

WINCE (19)

Windows CE

NCR3000 (20)

NCR 3000

NetWare (21)

OSF (22)

DC/OS (23)

Reliant UNIX (24)

SCO UnixWare (25)

SCO OpenServer (26)

Sequent (27)

IRIX (28)

Solaris (29)

SunOS (30)

U6000 (31)

ASERIES (32)

A Series

TandemNSK (33)

Tandem NSK

TandemNT (34)

Tandem NT

BS2000 (35)

BS2000/OSD

LINUX (36)

Lynx (37)

XENIX (38)

VM/ESA (39)

Interactive UNIX (40)

BSDUNIX (41)

BSD UNIX

FreeBSD (42)

NetBSD (43)

GNU Hurd (44)

OS9 (45)

Mac OS 9

MACH Kernel (46)

Inferno (47)

QNX (48)

EPOC (49)

IxWorks (50)

VxWorks (51)

MiNT (52)

BeOS (53)

HP MPE (54)

NextStep (55)

PalmPilot (56)

Palm OS

Rhapsody (57)

Windows 2000 (58)

Dedicated (59)

VSE (60)

TPF (61)

Version
Data type: string
Access type: Read-only
Qualifiers: Propagated ("CIM_SoftwareElement.Version"), CIM_key, Maxlen (64), Mappingstrings ("MIF.DMTF|ComponentID|001.3")

Version of the operation.

The version of the operation should be in one of the following forms:

  • <major>.<minor>.<revision>
  • <major>.<minor><letter><revision>

This property is inherited from CIM_Check.

Remarks

WMI does not implement this class. For classes derived from CIM_FileSpecification, 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_Check

 

 

Show: