ホーム › NetworkManagement.WNet › PF_NPSearchDialog

PF_NPSearchDialog

コールバック

シグネチャ

DWORD PF_NPSearchDialog(
    HWND hwndParent,
    NETRESOURCEW* lpNetResource,
    void* lpBuffer,
    DWORD cbBuffer,
    DWORD* lpnFlags
);

パラメーター

フィールド	型	説明
hwndParent	HWND	ダイアログボックスの親ウィンドウとして使用するウィンドウのハンドルです。
lpNetResource	NETRESOURCEW*	ネットワーク接続ダイアログボックスで現在選択されている項目へのポインターです。プロバイダーはこのフィールドを無視してもかまいません。
lpBuffer	void*	検索の結果を受け取るバッファーへのポインターです。
cbBuffer	DWORD	渡されたバッファーのサイズを指定する DWORD です。
lpnFlags	DWORD*	ダイアログボックスが閉じられた後に特定の動作を強制するために、プロバイダーが設定できるフラグの DWORD へのポインターです。サポートされるフラグは WNSRCH_REFRESH_FIRST_LEVEL のみで、これはダイアログボックスが閉じられた後に、このプロバイダーの直下の第 1 階層を MPR に折りたたませてから展開し、更新させます。

公式ドキュメント

ネットワークベンダーが、接続ダイアログボックスに表示される階層ビューとは別に、独自の形式の参照および検索を提供できるようにします。ネットワークプロバイダーがこの関数をサポートしている場合、選択された項目がそのプロバイダーに属しているときに、接続ダイアログボックスは検索ボタンを有効にします。ユーザーが検索ボタンを押すと、接続ダイアログボックスは NPSearchDialog を呼び出してユーザーの要求を処理します。

戻り値

関数が成功し、ユーザーが OK をクリックした場合、NPSearchDialog は WN_SUCCESS を返します。それ以外の場合はエラー値を返します。エラー値は次のいずれかになります。その他のすべてのエラーは、プロバイダーのダイアログボックスが直接処理するか報告する必要があります。

戻り値	説明
WN_CANCEL	ユーザーが操作をキャンセルしました。
WN_MORE_DATA	入力バッファーが小さすぎます。

解説(Remarks)

プロバイダーが列挙をサポートしていない場合、そのプロバイダーのエントリをダブルクリックしたときの動作は、検索ダイアログボックスを呼び出すことになります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)