Fungsi NPSearchDialog (npapi.h)

Memungkinkan vendor jaringan untuk menyediakan bentuk penjelajahan dan pencarian mereka sendiri, di luar tampilan hierarkis yang disajikan dalam kotak dialog Koneksi . Jika penyedia jaringan mendukung fungsi ini, kotak dialog Koneksi akan mengaktifkan tombol Cari saat item yang dipilih milik penyedia tersebut. Jika pengguna menekan tombol Cari , kotak dialog Koneksi memanggil NPSearchDialog untuk menangani permintaan pengguna.

Sintaks

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

Parameter

[in] hwndParent

Gagang jendela yang akan digunakan sebagai jendela induk kotak dialog.

[in] lpNetResource

Arahkan ke item yang saat ini dipilih dalam kotak dialog Jaringan Connections. Penyedia dapat memilih untuk mengabaikan bidang ini.

[out] lpBuffer

Penunjuk ke buffer yang akan menerima hasil pencarian.

[out] cbBuffer

DWORD yang akan menentukan ukuran buffer yang diteruskan.

[in] lpnFlags

Arahkan ke DWORD bendera yang dapat diatur penyedia untuk memaksa tindakan tertentu setelah kotak dialog ditutup. Satu-satunya bendera yang didukung adalah WNSRCH_REFRESH_FIRST_LEVEL, yang memaksa MPR untuk menciutkan lalu memperluas dan menyegarkan tingkat pertama di bawah penyedia ini setelah kotak dialog ditutup.

Nilai kembali

Jika fungsi berhasil dan pengguna telah mengklik OK, NPSearchDialog harus mengembalikan WN_SUCCESS. Jika tidak, itu harus mengembalikan nilai kesalahan, yang bisa menjadi salah satu dari yang berikut ini. Semua kesalahan lainnya harus ditangani atau dilaporkan langsung oleh kotak dialog penyedia.

Keterangan

Jika penyedia tidak mendukung enumerasi, maka tindakan yang terkait dengan mengklik ganda entri penyedia akan memanggil kotak dialog Pencariannya .

Persyaratan