SMS_G_System_SoftwareUsageData Server WMI Class

Article
05/03/2011

Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

The SMS_G_System_SoftwareUsageData Windows Management Instrumentation (WMI) class is an SMS Provider server class, in Configuration Manager, that provides a view of raw metering data that combines file and user information with the raw data.

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties.

Class SMS_G_System_SoftwareUsageData : SMS_G_System
{
      String CompanyName;
      Boolean EndNotCaptured;
      DateTime EndTimeGMT;
      DateTime EndTimeLocal;
      String FileDescription;
      UInt32 FileID;
      String FileName;
      UInt32 FileSize;
      String FileVersion;
      Boolean InTSSession;
      String MeterDataID;
      UInt32 ProductLanguage;
      String ProductName;
      String ProductVersion;
      UInt32 ResourceID;
      Boolean StartNotCaptured;
      DateTime StartTimeGMT;
      DateTime StartTimeLocal;
      Boolean StillRunning;
      String UserName;
};

Methods

The SMS_G_System_SoftwareUsageData class does not define any methods.

Properties

CompanyName
Data type: String

Access type: Read/Write

Qualifiers: [ResID(6203), ResDLL("SMS_RXPL.dll")]

Name of the company that made the file, taken from the Company property of the file version resources.

EndNotCaptured
Data type: Boolean

Access type: Read/Write

Qualifiers: [ResID(6708), ResDLL("SMS_RXPL.dll")]

true if the metering agent could not capture the actual end time of the process.

EndTimeGMT
Data type: DateTime

Access type: Read/Write

Qualifiers: [key, ResID(6704), ResDLL("SMS_RXPL.dll")]

The date and time, in Universal Coordinated Time (UTC), when the process stopped running, if StillRunning is false. If it is true, EndTimeGMT indicates the time when the data was reported.

EndTimeLocal
Data type: DateTime

Access type: Read/Write

Qualifiers: [ResID(6705), ResDLL("SMS_RXPL.dll")]

The date and time, in the local time zone of the client, when the process stopped running, if StillRunning is false. If it is true, EndTimeGMT indicates the time when the data was reported.

FileDescription
Data type: String

Access type: Read/Write

Qualifiers: [ResID(6305), ResDLL("SMS_RXPL.dll")]

Description of the metered file, taken from the files version resources.

FileID
Data type: UInt32

Access type: Read/Write

Qualifiers: [ResID(6302), ResDLL("SMS_RXPL.dll")]

ID of the file that was metered. To find the file information, the application matches this property to the ID in SMS_ProductFileInfo Server WMI Class. To find the rules that caused the file to be metered, the application matches FileID to the ID in SMS_MeteredFiles Server WMI Class.

FileName
Data type: String

Access type: Read/Write

Qualifiers: [ResID(6304), ResDLL("SMS_RXPL.dll")]

File name of the metered file if the metering rule matched the file name. If it did not match, but the OriginalFileName property of the rule matched the original file name in the files version resources, this property represents the original file name.

FileSize
Data type: UInt32

Access type: Read/Write

Qualifiers: [ResID(6307), ResDLL("SMS_RXPL.dll")]

Size of the metered file.

FileVersion
Data type: String

Access type: Read/Write

Qualifiers: [ResID(6306), ResDLL("SMS_RXPL.dll")]

File version of the metered file, taken from the file version resources.

InTSSession
Data type: Boolean

Access type: Read/Write

Qualifiers: [ResID(6709), ResDLL("SMS_RXPL.dll")]

true if the file was used in a Terminal Server session. Set this property to false if the file was used in a Configuration Manager console session.

MeterDataID
Data type: String

Access type: Read/Write

Qualifiers:

[key, ResID(6701), ResDLL("SMS_RXPL.dll")]

Unique ID of a particular instance of a running process on a computer. A record with this ID is created every time the client reports on the same instance of a running program.

ProductLanguage
Data type: UInt32

Access type: Read/Write

Qualifiers: [ResID(6206), ResDLL("SMS_RXPL.dll"), Subtype("Locale Id")]

Language ID of the metered file, taken from the file version resources.

ProductName
Data type: String

Access type: Read/Write

Qualifiers: [ResID(6204), ResDLL("SMS_RXPL.dll")]

Product name of the metered file, taken from the file version resources. This is not the product name of the rule that caused the file to be metered.

ProductVersion
Data type: String

Access type: Read/Write

Qualifiers: [ResID(6205), ResDLL("SMS_RXPL.dll")]

Product version of the metered file, taken from the file version resources.

ResourceID
Data type: UInt32

Access type: Read/Write

Qualifiers: [key, ResID(6201), ResDLL("SMS_RXPL.dll")]

See SMS_G_System Server WMI Class.

For this class, this property represents the ID of the computer that executed the metered program. To find the computer information, your application finds the record with the same resource ID in the SMS_R_System Server WMI Class class.

StartNotCaptured
Data type: Boolean

Access type: Read/Write

Qualifiers: [ResID(6707), ResDLL("SMS_RXPL.dll")]

true if the metering agent could not capture the actual start time of the process.

StartTimeGMT
Data type: DateTime

Access type: Read/Write

Qualifiers: [ResID(6702), ResDLL("SMS_RXPL.dll")]

The date and time, in Universal Coordinated Time (UTC), when the program started, if Started is true. If it is false, StartTimeGMT is the end time (EndTime) of the previous report for this program.

StartTimeLocal
Data type: DateTime

Access type: Read/Write

Qualifiers: [ResID(6703), ResDLL("SMS_RXPL.dll")]

The date and time, in the local time zone of the client, when the program started, if Started is true. If it is false, StartTimeGMT is the end time (EndTime) of the previous report for this program.

StillRunning
Data type: Boolean

Access type: Read/Write

Qualifiers: [ResID(6706), ResDLL("SMS_RXPL.dll")]

true if the program is still running. Set this property to false if EndTime represents the actual end time of the metered program.

UserName
Data type: String

Access type: Read/Write

Qualifiers: [ResID(6710), ResDLL("SMS_RXPL.dll")]

Fully qualified user name of the user of the metered application.

Remarks

There are no special class qualifiers for this class. For more information about both the class qualifiers and the property qualifiers included in the Properties section, see Configuration Manager Class and Property Qualifiers.

When a file is metered, information about that file is sent with the process execution information. This is a subset of the information that is reported by software inventory.

Requirements

Runtime Requirements

For more information, see Configuration Manager Server Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Server Development Requirements.