スクリプト API 定数
WMI では、WMI 用スクリプト API でのメソッド呼び出しの iflags パラメーターで、いくつかの種類の定数を使用します。
Visual Basic アプリケーションには、スクリプト API のタイプ ライブラリである Wbemdisp.tlb を含めることができます。 「WMI スクリプト タイプ ライブラリの使用」で説明されているとおり、Windows Script Host (WSH) XML 形式の <REFERENCE> タグや <OBJECT> タグが使用されていない限り、スクリプトを使用してもタイプ ライブラリ内の定数にアクセスすることはできません。 それ以外の場合、スクリプトには定数の値を使用する必要があります。
定数
-
セキュリティ認証レベルを定義します。
-
クラスまたはインスタンスへの書き込み操作の実行方法を定義します。
-
プロパティ値の有効な CIM 型を定義します。
-
オブジェクト比較の設定を定義し、SWbemObject.CompareTo_ によって使用されます。
-
リモート コンピューター上の WMI への接続が失敗したときに SWbemLocator.ConnectServer メソッドへの呼び出しでパラメーターとして使用されるセキュリティ フラグを定義します。
-
WMI 用スクリプト API 呼び出しによって返される可能性があるエラーを定義します。
-
SWbemServices.ExecQuery、SWbemServices.ExecQueryAsync、SWbemServices.SubclassesOf、SWbemServices.InstancesOf によって使用される定数を定義します。
-
セキュリティ偽装レベルを定義します。 これらの定数は、SWbemSecurity と共に使用されます。
-
SWbemObjectEx.GetText_ によって使用される有効なオブジェクト テキスト形式を定義します。
-
特権を定義します。 これらの定数は、一部の操作に必要な特権を付与するために SWbemSecurity と共に使用されます。
-
呼び出しによって返されるオブジェクトの数を決める、列挙またはクエリの深さを定義します。
-
生成されたオブジェクト テキストの内容を定義し、SWbemObject.GetObjectText_ によって使用されます。
-
タイムアウト定数を定義します。 この定数は、SWbemEventSource.NextEvent によって使用されます。
フラグの組み合わせ
フラグを組み合わせて、API 呼び出しの複数の側面に影響を与えることができます。
たとえば、semisynchronous 呼び出しを作成するには、SWbemServices.ExecQuery_ 呼び出しの iFlags パラメーターに、WbemFlagReturnImmediately と WbemFlagForwardOnly という 2 つのフラグを含める必要があります。 WbemFlagReturnImmediately の値は 16、WbemFlagForwardOnly の値は 32 です。 定数には名前でアクセスできないため、これらのフラグの値は組み合わせられ、iFlags の値 48 が生成されます。
次のスクリプト例では、呼び出しを示します。
On Error Resume Next
For Each obj in GetObject("WinMgmts:").ExecQuery _
("SELECT * FROM Win32_NTLogEvent WHERE _ LogFile='Application'",,48)
count = count + 1
Next
フラグの多くは相互に排他的であり、予期しない結果を生む可能性があるため、すべてのフラグを組み合わせることができるわけではありません。
関連トピック