NPSearchDialog 函式 (npapi.h)

  • 發行項

可讓網路廠商提供自己的流覽和搜尋形式，超出 [ 連線 ] 對話框中呈現的階層式檢視。 如果網路提供者支援此函式，當選取的專案屬於該提供者時，[ 連線 ] 對話框將會啟用 [搜尋 ] 按鈕。 如果使用者按下 [搜尋 ] 按鈕，[ 連線 ] 對話框會呼叫 NPSearchDialog 來處理使用者要求。

語法

DWORD NPSearchDialog(
  [in]  HWND           hwndParent,
  [in]  LPNETRESOURCEW lpNetResource,
  [out] LPVOID         lpBuffer,
  [out] DWORD          cbBuffer,
  [in]  LPDWORD        lpnFlags
);

參數

[in] hwndParent

要當做對話框父視窗使用的視窗句柄。

[in] lpNetResource

[網络 Connections] 對話框中目前選取專案的指標。 提供者可以選擇忽略此欄位。

[out] lpBuffer

將接收搜尋結果的緩衝區指標。

[out] cbBuffer

DWORD ，指定傳入的緩衝區大小。

[in] lpnFlags

提供者可以在關閉對話框之後強制執行特定動作的 DWORD 旗標指標。 唯一支援的旗標是WNSRCH_REFRESH_FIRST_LEVEL，這會強制 MPR 折疊，然後在關閉對話框之後展開並重新整理此提供者下方的第一層。

傳回值

如果函式成功，且使用者已按兩下 [ 確定]， NPSearchDialog 應該會傳回WN_SUCCESS。 否則，它應該會傳回錯誤值，可以是下列其中一項。 所有其他錯誤都應該由提供者的對話框直接處理或報告。

傳回碼 Description
WN_CANCEL
 使用者已取消作業。
WN_MORE_DATA
 輸入緩衝區太小。

備註

如果提供者不支援列舉，則與按兩下提供者專案相關聯的動作將會叫用其 [搜尋 ] 對話方塊。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 npapi.h