Fungsi NPSearchDialog (npapi.h)

  • Artikel

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.

Menampilkan kode Deskripsi
WN_CANCEL
 Pengguna membatalkan operasi.
WN_MORE_DATA
 Buffer input terlalu kecil.

Keterangan

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

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header npapi.h