AddAssociation Method in Class SMS_StateMigration

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 AddAssociation Windows Management Instrumentation (WMI) class method, in Configuration Manager, adds the computer association between two system resources used in state migration.

The following syntax is simplified from Managed Object Format (MOF) code and defines the method.

SInt32 AddAssociation(
      UInt32 SourceClientResourceID,
      UInt32 RestoreClientResourceID,
      SMS_StateMigrationUserNames UserNames[]
);

Parameters

SourceClientResourceID
Data type: UInt32

Qualifiers: [in]

Resource ID for the source client.

RestoreClientResourceID
Data type: UInt32

Qualifiers: [in]

Resource ID for the destination client.

UserNames
Data type: SMS_StateMigrationUserNames Array

Qualifiers: [in]

SMS_StateMigrationUserNames Server WMI Class objects representing the names of users with profiles to be migrated. These objects are defined by the UserNames property of SMS_StateMigration Server WMI Class.

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.

Remarks

For an example of the use of this method, see How to Create an Association Between Two Computers in Configuration Manager. To remove an association, your application can call the DeleteAssociation Method in Class SMS_StateMigration.

Requirements

Runtime Requirements

For more information, see Configuration Manager Server Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Server Development Requirements.

Partager via