クラス SMS_ContextMethods の GetContextHandle メソッド

Configuration Manager の GetContextHandle メソッドは、サーバー上にコンテキスト オブジェクトを格納します。

次の構文は、マネージ オブジェクト形式 (MOF) コードから簡素化され、メソッドを定義したものです。

構文

SInt32 GetContextHandle(
      String ContextHandle
);

パラメーター

ContextHandle データ型: String

Qualifiers: [out]

サーバー上のキャッシュされたコンテキスト オブジェクトを識別するコンテキスト ハンドル。

戻り値

成功した場合は 0、失敗の場合は 0 以外を示す SInt32 データ型。

注釈

このメソッドを使用して、コンテキスト オブジェクトの内容を取得したコンテキスト ハンドルで示されたオブジェクトに置き換えます。 コンテキスト オブジェクト データをサーバーに格納すると、多数のコンテキスト修飾子または大量の修飾子データを使用して SMS プロバイダーを繰り返し呼び出すクライアント アプリケーションのネットワーク帯域幅を節約できます。

この最適化手法を使用するために必要な手順の詳細については、「Configuration Manager コンテキスト修飾子」の ContextHandle 修飾子を参照してください。

要件

ランタイム要件

詳細については、「Configuration Manager サーバー ランタイム要件」を参照してください。

開発要件

詳細については、「Configuration Manager サーバー開発の要件」を参照してください。

関連項目

SMS_ContextMethods クラスClearContextHandle