ホーム › System.GroupPolicy › IGPMSearchCriteria
IGPMSearchCriteria
COMIDispatch (デュアル)✅ IDispatch を実装(デュアルインターフェース)。HSP では
comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
IGPMSearchCriteria インターフェイスは、グループ ポリシー管理コンソール (GPMC) のインターフェイスを使用する際に、検索操作で使用する条件を定義するためのものです。GPMSearchCriteria オブジェクトを作成するには、IGPM::CreateSearchCriteria メソッドを呼び出します。
メソッド 1
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
vtbl 7 HRESULT Add(GPMSearchProperty searchProperty, GPMSearchOperation searchOperation, VARIANT varValue)
検索操作の条件を追加します。
| searchProperty | GPMSearchProperty | in | 評価対象の検索プロパティ。検索プロパティ、検索操作、値の有効な組み合わせについては、「解説」セクションを参照してください。 |
| searchOperation | GPMSearchOperation | in | varValue で指定された値を使用して searchProperty を評価するために使用する操作。 |
| varValue | VARIANT | in | searchProperty を評価する対象となる値。 |
戻り値
解説(Remarks)
次の表は、searchProperty、searchOperation、varValue の各パラメーターの有効な組み合わせを示しています。
注意 IGPMSearchCriteria::Add を複数回呼び出すと、検索条件の論理積 (And) 演算になります。この呼び出しは論理和 (Or) 演算の機能をサポートしていません。また、個々の条件に対する否定 (Not) は指定できますが、検索結果に対する否定 (Not) は実行できません。
| 検索プロパティ | 検索演算子 | 値 |
|---|---|---|
| gpoPermissions |
opContains
opNotContains |
GPMPermission |
| gpoEffectivePermissions |
opContains
opNotContains |
GPMPermission |
| gpoID |
opEquals
opNotEquals |
GUID |
| somLinks | opContains | GPMGPO |
| gpoDomain | opEquals | GPMDomain |
| backupMostRecent | opEquals | TRUE |
| gpoWMIFilter | opEquals | GPMWMIFilter |
| backupDomain | opEquals | ドメイン名を含む文字列 |
| gpoComputerExtensions |
opContains
opNotContains |
GUID |
| gpoUserExtensions |
opContains
opNotContains |
GUID |
| gpoDisplayName |
opEquals
opContains opNotContains |
ユーザーにわかりやすい GPO の表示名。 |
| starterGPOPermissions |
opContains
opNotContains |
GPMPermission |
| starterGPOEffectivePermissions |
opContains
opNotContains |
GPMPermission |
| starterGPODisplayName |
opEquals
opContains opNotContains |
ユーザーにわかりやすいスターター GPO の表示名。 |
| starterGPOID |
opEquals
opNotEquals |
GUID |
| starterGPODomain | opEquals | GPMDomain |
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IGPMSearchCriteria "{D6F11C42-829B-48D4-83F5-3615B67DFC22}"
#usecom global IGPMSearchCriteria IID_IGPMSearchCriteria "{}"
#comfunc global IGPMSearchCriteria_Add 7 int,int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。