OPENQUERYWINDOW 構造体 (cmnquery.h)
OPENQUERYWINDOW 構造体は、ICommonQuery::OpenQueryWindow メソッドと共に使用され、ディレクトリ サービス クエリ ダイアログ ボックスを初期化します。
構文
typedef struct {
DWORD cbStruct;
DWORD dwFlags;
CLSID clsidHandler;
LPVOID pHandlerParameters;
CLSID clsidDefaultForm;
IPersistQuery *pPersistQuery;
union {
void *pFormParameters;
IPropertyBag *ppbFormParameters;
};
} OPENQUERYWINDOW, *LPOPENQUERYWINDOW;
メンバー
cbStruct
構造体のサイズをバイト単位で格納します。 このメンバーは、バージョン管理とパラメーターの検証に使用され、 ICommonQuery::OpenQueryWindow を呼び出す前に入力する必要があります。
dwFlags
ディレクトリ サービス クエリ ダイアログ ボックスの動作を定義するフラグのセットが含まれます。 0 または次の一覧に示す 1 つ以上の値の組み合わせを指定できます。
OQWF_DEFAULTFORM
クエリ ダイアログ ボックスで、初期化時に clsidDefaultForm メンバーによって指定されたフォームを選択します。
OQWF_HIDEMENUS
ダイアログ ボックスでメニュー バーが非表示になります。
OQWF_HIDESEARCHUI
標準の検索ユーザー インターフェイスを使用せずにクエリ ダイアログ ボックスを作成します。 これには、[Find Now]\( 今すぐ検索\)、[ Stop]\(停止 \) および [Clear All]\(すべてクリア \) のプッシュ ボタンが含まれます。
OQWF_ISSUEONOPEN
クエリ ダイアログ ボックスが最初に表示されたときに、クエリが実行されるようにします。
OQWF_LOADQUERY
クエリ ダイアログ ボックスで、pPersistQuery メンバーの IPersistQuery インターフェイスからクエリを取得します。
OQWF_OKCANCEL
クエリ ダイアログ ボックスに [OK] ボタンと [キャンセル ] ボタン (該当する場合) が表示されます。 ダイアログ ボックスに実際に表示されるボタンは、使用されるフォームと、指定された他のフラグによって異なります。
OQWF_PARAMISPROPERTYBAG
ppbFormParameters メンバーに IPropertyBag インターフェイスが含まれていることを示します。
OQWF_REMOVEFORMS
検索: ラベルで表されるフォーム選択ラベルとドロップダウン リストを使用せずに、クエリ ダイアログ ボックスを作成します。
OQWF_REMOVESCOPES
[ 入力: ] ラベルで表されるスコープ ラベルとドロップダウン リストを使用せずに、クエリ ダイアログ ボックスを作成します。
OQWF_SAVEQUERYONOK
クエリ ダイアログ ボックスを閉じると、pPersistQuery メンバーの IPersistQuery インターフェイスにクエリを保存します。
OQWF_SHOWOPTIONAL
クエリ ダイアログ ボックスにオプションのフォームがフォーム のドロップダウン リストに表示されます。 省略可能なフォームは、CQFORM 構造体の dwFlags メンバーのCQFF_ISOPTIONAL フラグを指定するフォームです。
OQWF_SINGLESELECT
クエリダイアログ ボックスでクエリ結果リストを単一選択にします。
clsidHandler
クエリ ダイアログ ボックスで使用するクエリ ハンドラーを指定する CLSID 値が含まれます。 このメンバーの値は、 pHandlerParameters メンバーが指す構造体の種類も決定します。
CLSID_DsQuery
これは標準のディレクトリ サービス クエリであり、現在サポートされている唯一のクエリです。
pHandlerParameters
クエリ ハンドラーのデータを含む構造体へのポインター。 このメンバーが指す構造体の型は、 clsidHandler メンバーによって定義されます。 次の一覧に、 clsidHandler メンバーの値に基づいて使用できる構造体の種類を示します。
CLSID_DsQuery
DSQUERYINITPARAMS 構造体へのポインターを格納します。
clsidDefaultForm
クエリ ダイアログ ボックスに表示する既定のフォームを指定します。 dwFlags にOQWF_DEFAULTFORMが含まれていない場合、このメンバーは無視されます。 このメンバーには、カスタム クエリ フォームの CLSID またはシステム指定のフォームのいずれかを含めることができます。
CLSID_DsFindAdvanced
カスタム検索クエリ フォームを識別します。
CLSID_DsFindComputer
[コンピューター] クエリ フォームを識別します。
CLSID_DsFindContainer
[組織単位] クエリ フォームを識別します。
CLSID_DsFindDomainController
ドメイン コントローラーのクエリ フォームを識別します。
CLSID_DsFindFrsMembers
FRS メンバー クエリ フォームを識別します。
CLSID_DsFindObjects
予約済み。
CLSID_DsFindPeople
[ユーザー]、[連絡先]、[グループ] クエリ フォームを識別します。
CLSID_DsFindPrinter
Printers クエリ フォームを識別します。
CLSID_DsFindVolume
[共有フォルダー] クエリ フォームを識別します。
CLSID_DsFindWriteableDomainController
ドメイン コントローラーのクエリ フォームを識別し、書き込み可能なドメイン コントローラーを表示します。
pPersistQuery
クエリ データの格納と取得に使用される IPersistQuery インターフェイスへのポインター。 このデータは、クエリの結果ではなく、クエリ自体に関連します。 dwFlags にOQWF_LOADQUERYが含まれている場合、クエリ データはこのインターフェイスから取得されます。 dwFlags にOQWF_SAVEQUERYが含まれている場合、クエリ データはこのインターフェイスに保存されます。
pFormParameters
予約済み。 フォームのパラメーター初期化データを提供する構造体またはインターフェイスへのポインター。 このポインターの内容は、 clsidDefaultForm メンバーによって指定されたフォーム クラスによって定義されます。
ppbFormParameters
フォームのパラメーター初期化データを提供する IPropertyBag インターフェイスへのポインター。 このプロパティ バッグの内容は、 clsidDefaultForm メンバーによって指定されたフォーム クラスによって定義されます。 このメンバーは、次のシステム指定フォームでサポートされています。
CLSID_DsFindPrinter
このフォームは、プロパティ バッグから次のプロパティを取得します。
| プロパティ名 | 説明 |
|---|---|
| printName | 初期プリンター名を含みます。 |
| printLocation | 最初のプリンターの場所を格納します。 |
| printModel | プリンターの最初のモデル名または番号を含みます。 |
CLSID_DsFindComputer
このフォームを使用して、コンピューターの役割を指定します。 プロパティ バッグには computerRole を含める必要があります。 次の値の組み合わせを使用して、含めるロールを制限します。
| 値 | ロール |
|---|---|
| 0x0000 | すべてのロール |
| 0x0001 | ワークステーションまたはサーバー |
| 0x0002 | すべてのドメイン コントローラー |
| 0x0004 | 書き込み可能なドメイン コントローラー |
| 0x0008 | Read-Only Domain Controllers |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| Header | cmnquery.h |