SMS_SiteControlFile 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_SiteControlFile Windows Management Instrumentation (WMI) class is an SMS Provider server class, in Configuration Manager, that represents the site control file and contains methods to maintain version control of the site control file.

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

Class SMS_SiteControlFile : SMS_BaseClass 
{
     String BuildNumber;
     UInt32 FileType;
     String FormatVersion;
     String SCFData;
     UInt32 SerialNumber;
     String SiteCode;
};

Methods

The following table lists the methods in SMS_SiteControlFile.

Method	Description
Commit	This method is obsolete.
CommitSCF Method in Class SMS_SiteControlFile	Applies changes to the Configuration Manager database. This method replaces the Commit method.
GetCurrentVersion Method in Class SMS_SiteControlFile	Retrieves the full text of the site control file from memory.
GetSessionHandle Method in Class SMS_SiteControlFile	Gets an in-memory copy of the site control file and a session handle.
Refresh	This method is obsolete.
RefreshSCF Method in Class SMS_SiteControlFile	Refreshes the in-memory copy of the site control file with any recent changes from the database. This method replaces the Refresh method.
ReleaseSessionHandle Method in Class SMS_SiteControlFile	Releases the in-memory copy of the site control file and any resources associated with the session handle.

Properties

BuildNumber
Data type: String

Access type: Read/Write

Qualifiers: [lazy]

Build number of the Configuration Manager installation that create the site control file. The default value is "".

FileType
Data type: UInt32

Access type: Read/Write

Qualifiers: [key, enumeration:ToSubClass]

Type of site control file. Possible values are listed below. Currently only the ACTUAL (1) and PROPOSED (2) values are available. PROPOSED is the default value.

0

EMPTY (deprecated)

1

ACTUAL

2

PROPOSED

4

TRANSACTIONS (deprecated)

6

LOCAL_TRANSACTIONS (deprecated)

7

1XSTYLE (deprecated)

FormatVersion
Data type: String

Access type: Read/Write

Qualifiers: [lazy]

Version of the site control file format. The default value is "".

SCFData
Data type: String

Access type: Read/Write

Qualifiers: [lazy, large]

Current site control file data in text format (accumulated deltas).

SerialNumber
Data type: UInt32

Access type: ReadWrite

Qualifiers: [key]

Unique ID of the file itself. The number is incremented every time the file changes. The default value is 0.

SiteCode
Data type: String

Access type: Read-only

Qualifiers: [key, read, SizeLimit("3")]

Site code of the site associated with the site control file. The default value is "".

Remarks

Class qualifiers for this class include:

Read (read-only)

For more information about both the class qualifiers and the property qualifiers included in the Properties section, see Configuration Manager Class and Property Qualifiers.

Your application uses the methods of this class to perform version control of the site control file. To update the contents of the site control file, the application should use classes derived from SMS_SiteControlItem Server WMI Class.

Requirements

Runtime Requirements

For more information, see Configuration Manager Server Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Server Development Requirements.