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を返します。 それ以外の場合は、次のいずれかのエラー値を返す必要があります。 その他のすべてのエラーは、プロバイダーのダイアログ ボックスで直接処理または報告する必要があります。
リターン コード | 説明 |
---|---|
|
ユーザーが操作を取り消しました。 |
|
入力バッファーが小さすぎます。 |
注釈
プロバイダーが列挙をサポートしていない場合、プロバイダーのエントリをダブルクリックすると関連付けられているアクションは、その [検索 ] ダイアログ ボックスを呼び出すようになります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | npapi.h |