RequestRefresh Method in Class SMS_Collection

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 RequestRefresh Windows Management Instrumentation (WMI) class method, in Configuration Manager, triggers a re-evaluation of collection membership by the Configuration Manager collection evaluator component.

The following syntax is simplified from Managed Object Format (MOF) code and is intended to show the definition of the method.

SInt32 RequestRefresh(
     Boolean includesubcollections
);

Parameters

  • includesubcollections
    Data type: Boolean

    Qualifiers: [in]

    true if subcollections are also marked for evaluation. If this parameter is set to false, subcollections are not included.

Return Values

An SInt32 data type that is 0 to indicate success or non-zero to indicate failure.

For information about handling returned errors, see About Configuration Manager Errors.

Example Code

For an example that uses the RequestRefresh method, see How to Create a Dynamic Collection.

Requirements

Runtime Requirements

For more information, see Configuration Manager Server Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Server Development Requirements.

See Also

Reference

SMS_Collection Server WMI Class

Concepts

How to Create a Subcollection
How to Create a Static Collection
How to Create a Dynamic Collection