ビュー プロバイダーに固有の修飾子

ビュー プロバイダー クラスの定義に使われる修飾子の一覧を次に示します。

注意

ビュー プロバイダー クラスは、リモート参照を使うときは NetBIOS 名のみをサポートします。 リモート参照で IP アドレスまたは DNS 名を使うと、接続は 0x800706ba エラーで失敗します。

Direct

データ型: boolean

関連付け参照がビュー参照にマップされないようにするため、ビュー関連付けプロパティと共に使われます。

次の例では、GroupComponent プロパティを、ビュー参照にマップされない関連付け参照として定義しています。

[Direct, key, PropertySources
{"GroupComponent"}]

HiddenDefault

データ型: boolean

異なる既定値を持つソース クラス プロパティに基づくビュー クラス プロパティの既定値。 基になるソース クラスは、ビューによって暗黙的に示されます。

たとえば、ソース クラス Win32_ScheduledJob には、ジョブを定期的に実行するか、1 回だけ実行するかを示す boolean プロパティ RunRepeatedly があります。 RunRepeatedly の既定値は、Win32_ScheduledJob の場合は True ではありませんが、ビュー クラスの場合は True です。

#pragma namespace("\\\\.\\root\\ns_view")
[Union,
ViewSources{"select * from Win32_ScheduledJob where RunRepeatedly=True"},
ViewSpaces{"\\\\.\\root\\cimv2"},
dynamic,provider("MS_VIEW_INSTANCE_PROVIDER")]
Class View_PeriodicJob
{
 [key, PropertySources{"JobId"}]
 uint32 JobId;
 [PropertySources{"Command"}]
 string Command;
 [HiddenDefault,PropertySources{"RunRepeatedly"}]
 boolean Repeat = True;
};

JoinOn

データ型: string

結合ビュー クラスでのソース クラス インスタンスの結合方法を定義します。 次に示すのは、JoinOn 修飾子を使って 2 つのソース クラスを結合する方法の例です。

JoinOn("Win32Perf_RawProcess.IDProcess = Win32Perf_RawThread.IDProcess")

MethodSource

データ型: string array

ビュー メソッドに対して実行するソース メソッド。 同様の構文については、「 PropertySources 修飾子」をご覧ください。 メソッドのシグネチャは、ソース クラスのシグネチャと正確に一致している必要があります。 ソース クラスが定義されている MOF ファイルからメソッドのシグネチャをコピーします。 次の例では、Win32_NTEventlogFileClearEventLog メソッドからメソッドを定義しています。

[implemented, MethodSource
{"ClearEventlog"}]
  uint32   VClearEventlog([in] string ArchiveFileName);

この修飾子は、共用体ビューで使われる場合にのみ有効です。

PostJoinFilter

データ型: string

結合クラスで結合された後のインスタンスをフィルター処理する WQL クエリ。

PropertySources

データ型: string array

ビュー クラス プロパティがデータを取得するソース プロパティ。

Union

データ型: boolean

共用体クラスを定義しているかどうかを示します。 共用体ビューには、ソース インスタンスの和集合に基づくインスタンスが含まれます。 たとえば、次のように宣言できます。

Union, ViewSources{"SELECT Handle, Name, CreationDate FROM Win32_Process", 
                   "SELECT Caption, Name, ProcessHandle FROM Win32_Thread"}.

ViewSources

データ型: string array

特定のビュー クラスで使われるソース インスタンスとプロパティを定義する WMI クエリ言語 (WQL) のクエリのセット。 すべての配列修飾子の位置が対応していることが重要です。

ViewSpaces

データ型: string array

ソース インスタンスが配置されている名前空間。

要件

要件
サポートされている最小のクライアント
Windows Vista
サポートされている最小のサーバー
Windows Server 2008