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 は強制的に折りたたみ、展開し、このプロバイダーの下の最初のレベルを更新します。

戻り値

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

リターン コード 説明
WN_CANCEL
 ユーザーが操作を取り消しました。
WN_MORE_DATA
 入力バッファーが小さすぎます。

注釈

プロバイダーが列挙をサポートしていない場合、プロバイダーのエントリをダブルクリックすると関連付けられているアクションは、その [検索 ] ダイアログ ボックスを呼び出すようになります。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー npapi.h