ビュー プロバイダーに固有の修飾子
ビュー プロバイダー クラスの定義に使われる修飾子の一覧を次に示します。
注意
ビュー プロバイダー クラスは、リモート参照を使うときは 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_NTEventlogFile の ClearEventLog メソッドからメソッドを定義しています。
[implemented, MethodSource
{"ClearEventlog"}]
uint32 VClearEventlog([in] string ArchiveFileName);
この修飾子は、共用体ビューで使われる場合にのみ有効です。
データ型: string
結合クラスで結合された後のインスタンスをフィルター処理する WQL クエリ。
データ型: string array
ビュー クラス プロパティがデータを取得するソース プロパティ。
Union
データ型: boolean
共用体クラスを定義しているかどうかを示します。 共用体ビューには、ソース インスタンスの和集合に基づくインスタンスが含まれます。 たとえば、次のように宣言できます。
Union, ViewSources{"SELECT Handle, Name, CreationDate FROM Win32_Process",
"SELECT Caption, Name, ProcessHandle FROM Win32_Thread"}.
データ型: string array
特定のビュー クラスで使われるソース インスタンスとプロパティを定義する WMI クエリ言語 (WQL) のクエリのセット。 すべての配列修飾子の位置が対応していることが重要です。
データ型: string array
ソース インスタンスが配置されている名前空間。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows Vista |
サポートされている最小のサーバー |
Windows Server 2008 |