GetContextHandle Method in Class SMS_ContextMethods

  • 아티클

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 GetContextHandle method, in Configuration Manager, stores context objects on the server.

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

SInt32 GetContextHandle(
      String ContextHandle
);

Parameters

  • ContextHandle
    Data type: String

    Qualifiers: [out]

    Context handle that identifies the cached context object on the server.

Return Values

An SInt32 data type that indicates 0 for success or non-zero for failure.

Remarks

Use this method to replace the contents of your context object with the object indicated by the retrieved context handle. Storing context object data on the server saves network bandwidth for client applications that repeatedly call the SMS Provider using a large number of context qualifiers or a large amount of qualifier data.

For a complete description of the steps required to use this optimization technique, see the ContextHandle qualifier in Configuration Manager Context Qualifiers.

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

Concepts

SMS_ContextMethods Class
ClearContextHandle Method in Class SMS_ContextMethods