Win32_IniFileSpecification class

Article
05/31/2018

The Win32_IniFileSpecification WMI class contains the .INI information that an application needs to set in an .INI file. The .INI file information is written out when the corresponding component is selected for installation locally or from the source.

Note

For more information about support or requirements for installation on a specific operating system, see Operating System Availability of WMI Components.

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

Syntax

[Provider("MSIProv"), Dynamic]
class Win32_IniFileSpecification : CIM_FileSpecification
{
  uint16   Action;
  string   Caption;
  string   CheckID;
  boolean  CheckMode;
  uint32   CheckSum;
  uint32   CRC1;
  uint32   CRC2;
  datetime CreateTimeStamp;
  string   Description;
  uint64   FileSize;
  string   IniFile;
  string   Key;
  string   MD5Checksum;
  string   Name;
  string   Section;
  string   SoftwareElementID;
  uint16   SoftwareElementState;
  uint16   TargetOperatingSystem;
  string   Value;
  string   Version;
};

Members

The Win32_IniFileSpecification class has these types of members:

Methods
Properties

Methods

The Win32_IniFileSpecification class has these methods.

Method	Description
Invoke	Evaluates a specific check. The details of how the method evaluates a specific check in a CIM context are described by the nonabstract CIM_Check subclasses.

Properties

The Win32_IniFileSpecification class has these properties.

Action

Data type: uint16
Access type: Read-only

Type of modification made.

Value	Meaning
0 (0x0)	Creates or updates an .ini entry.
1 (0x1)	Creates an .ini entry only if the entry does not already exist.
3 (0x3)	Creates a new entry or appends a new comma-separated value to an existing entry.

Caption

Data type: string
Access type: Read-only

Short textual description of an object a one-line string.

CheckID

Data type: string
Access type: Read-only

Identifier used together with other keys to uniquely identify a check.

CheckMode

Data type: boolean
Access type: Read-only

Condition is expected to exist in the environment. When True, the condition is expected to exist. For example, a file is expected to be on a system, so the Invoke method is expected to return True.

CheckSum

Data type: uint32
Access type: Read-only

Checksum calculated as the 16-bit sum of the first 32 bytes of a file.

CRC1

Data type: uint32
Access type: Read-only

Cyclic Redundancy Check (CRC) value calculated by using the middle 512K bytes.

CRC2

Data type: uint32
Access type: Read-only

CRC value for the middle 512K bytes with an offset of modulo 3 to the start of a file of 0 (zero).

CreateTimeStamp

Data type: datetime
Access type: Read-only

Date the file is created.

Description

Data type: string
Access type: Read-only

Description of an object.

FileSize

Data type: uint64
Access type: Read-only

Size of a file.

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

IniFile

Data type: string
Access type: Read-only

Unique key that identifies an .ini file specification within its product.

Key

Data type: string
Access type: Read-only

Key of the .ini file within a section.

MD5Checksum

Data type: string
Access type: Read-only

MD5Checksum algorithm is a well-known algorithm for computing a 128-bit checksum for a file or object. The likelihood of two different files producing the same MD5 checksum is very small (about 1 in 2^64). The MD5 checksum of a file can be used to construct a reliable content identifier that uniquely identifies a file. 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".

Name

Data type: string
Access type: Read-only

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

Section

Data type: string
Access type: Read-only

Section of an .ini file.

SoftwareElementID

Data type: string
Access type: Read-only

Identifier for a software element.

SoftwareElementState

Data type: uint16
Access type: Read-only

State of a software element.

Value	Meaning
1 (0x1)	Deployable
2 (0x2)	Installable
3 (0x3)	Executable
4 (0x4)	Running

TargetOperatingSystem

Data type: uint16
Access type: Read-only

Target operating system of a software element.

The values are:

Value	Meaning
0 (0x0)	Unknown
1 (0x1)	Other
2 (0x2)	MACOS
3 (0x3)	ATTUNIX
4 (0x4)	DGUX
5 (0x5)	DECNT
6 (0x6)	Digital UNIX
7 (0x7)	OpenVMS
8 (0x8)	HPUX
9 (0x9)	AIX
10 (0xA)	MVS
11 (0xB)	OS400
12 (0xC)	OS/2
13 (0xD)	JavaVM
14 (0xE)	MSDOS
15 (0xF)	WIN3x
16 (0x10)	WIN95
17 (0x11)	WIN98
18 (0x12)	WINNT
19 (0x13)	WINCE
20 (0x14)	NCR3000
21 (0x15)	NetWare
22 (0x16)	OSF
23 (0x17)	DC/OS
24 (0x18)	Reliant UNIX
25 (0x19)	SCO UnixWare
26 (0x1A)	SCO OpenServer
27 (0x1B)	Sequent
28 (0x1C)	IRIX
29 (0x1D)	Solaris
30 (0x1E)	SunOS
31 (0x1F)	U6000
32 (0x20)	ASERIES
33 (0x21)	TandemNSK
34 (0x22)	TandemNT
35 (0x23)	BS2000
36 (0x24)	LINUX
37 (0x25)	Lynx
38 (0x26)	XENIX
39 (0x27)	VM/ESA
40 (0x28)	Interactive UNIX
41 (0x29)	BSDUNIX
42 (0x2A)	FreeBSD
43 (0x2B)	NetBSD
44 (0x2C)	GNU Hurd
45 (0x2D)	OS9
46 (0x2E)	MACH Kernel
47 (0x2F)	Inferno
48 (0x30)	QNX
49 (0x31)	EPOC
50 (0x32)	IxWorks
51 (0x33)	VxWorks
52 (0x34)	MiNT
53 (0x35)	BeOS
54 (0x36)	HP MPE
55 (0x37)	NextStep
56 (0x38)	PalmPilot
57 (0x39)	Rhapsody

Value

Data type: string
Access type: Read-only

Value to be written.

Version

Data type: string
Access type: Read-only

Version of a software element. Values should be in the form [Major].[Minor].[Revision] or [Major].[Minor][letter][revision].

Remarks

The Win32_IniFileSpecification class is derived from CIM_FileSpecification.

Requirements


Minimum supported client	Windows XP
Minimum supported server	Windows Server 2003
Namespace	Root\CIMV2
MOF	Msi.mof
DLL	Msiprov.dll

Share via