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.

Method Description
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

Requirement Value
Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Namespace
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

See also

CIM_Check