dsqueryINITPARAMS 結構 (dsquery.h)

發行項
02/26/2024

DSQUERYINITPARAMS 結構描述用來初始化目錄服務查詢中瀏覽對話框的數據。

語法

typedef struct {
  DWORD  cbStruct;
  DWORD  dwFlags;
  LPWSTR pDefaultScope;
  LPWSTR pDefaultSaveLocation;
  LPWSTR pUserName;
  LPWSTR pPassword;
  LPWSTR pServer;
} DSQUERYINITPARAMS, *LPDSQUERYINITPARAMS;

成員

cbStruct

包含這個結構的大小，以位元組為單位。

dwFlags

包含定義查詢行為的一組旗標。這可以是零或下列一或多個值的組合。

DSQPF_ENABLEADMINFEATURES

使用目錄服務管理工具所支援的功能，例如管理員操作功能表和屬性頁的顯示規範。

DSQPF_ENABLEADVANCEDFEATURES

指定傳遞至操作功能表和屬性頁之 IDataObject 實例中的進階功能。

DSQPF_HASCREDENTIALS

這個結構的 pUserName、 pPassword 和 pServer 成員可以指定伺服器和認證數據。

DSQPF_NOCHOOSECOLUMNS

停用查詢對話框中的 [選擇 資料行] 專案 [ 檢視 ] 選單。

DSQPF_NOSAVE

從 [查詢] 對話框的 [檔案] 功能表移除 [儲存搜尋] 專案。

DSQPF_SAVELOCATION

pDefaultSaveLocation 成員包含將儲存搜尋的預設文件系統路徑。

DSQPF_SHOWHIDDENOBJECTS

導致查詢對話框在查詢結果清單中顯示隱藏的物件。

pDefaultScope

Null 終止的 Unicode 字串指標，其中包含搜尋之預設範圍的 ADsPath。如果未指定預設搜尋範圍，請將此成員設定為 NULL 。

pDefaultSaveLocation

Null 終止的 Unicode 字串指標，其中包含將儲存搜尋的預設檔案系統路徑。如果 dwFlags 成員不包含 DSQPF_SAVELOCATION，則會忽略此成員。

pUserName

Null 終止的 Unicode 字串指標，其中包含有效網域表示法中的用戶名稱，例如 “fabrikam\jeffsmith”。

pPassword

Null 終止 Unicode 字串的指標，其中包含 pUserName 成員所指定用戶的密碼。

pServer

Null 終止 Unicode 字串的指標，其中包含讀取受信任網域清單的伺服器名稱。此清單用來填入對話框中的 [In： ] 下拉式清單。

備註

此結構專屬於 CLSID_DsQuery 查詢處理程式。當CLSID_DsQuery為 OPENQUERYWINDOW 結構的 clsidHandler 成員設定時，這個結構會用於 OPENQUERYWINDOW 結構的 pHandlerParameters 成員。如需詳細資訊，以及使用此 API 和其他相關 API 的程式代碼範例，請參閱 ICommonQuery：：OpenQueryWindow。