Fungsi NPPropertyDialog (npapi.h)

  • Artikel

Dipanggil saat pengguna mengklik tombol yang ditambahkan dengan menggunakan fungsi NPPropertyDialog . Fungsi NPPropertyDialog hanya dipanggil untuk properti jaringan file dan direktori.

Sintaks

DWORD NPPropertyDialog(
  [in] HWND   hwndParent,
  [in] DWORD  iButtonDlg,
  [in] DWORD  nPropSel,
  [in] LPWSTR lpFileName,
  [in] DWORD  nType
);

Parameter

[in] hwndParent

Handel ke jendela induk yang harus memiliki kotak dialog properti file.

[in] iButtonDlg

Indeks tombol yang ditekan.

Indeks ini menentukan kotak dialog properti mana yang diminta, dimulai dengan satu untuk tombol pertama yang dikembalikan dari fungsi NPGetPropertyText . Jika ada beberapa nama file yang dipilih, 10 ditambahkan ke nomor ini. Dengan kata lain, jika ada lebih dari satu file yang dipilih dan pengguna menekan tombol properti pertama yang ditentukan penyedia, iButtonDlg akan menjadi 11. Jika hanya ada satu file yang dipilih dan pengguna menekan tombol properti jaringan kedua, iButtonDlg akan menjadi dua.

[in] nPropSel

Menentukan item apa yang harus ditindakkan oleh kotak dialog properti. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
WNPS_FILE
 Satu file.
WNPS_DIR
 Satu direktori.
WNPS_MULT
 Pilihan beberapa file, direktori, atau keduanya.

[in] lpFileName

Penunjuk ke nama item yang harus ditindakkan oleh kotak dialog properti. Satu-satunya item yang didukung adalah file dan direktori, sehingga nama item adalah nama file. Ini harus tidak ambigu, tidak berisi karakter kartubebas, dan sepenuhnya memenuhi syarat, misalnya, C:\Local\Example.doc. Beberapa nama file harus dipisahkan dengan spasi. Nama file yang berisi spasi dapat diapit dalam tanda kutip, misalnya, "C:\File Saya". Dalam hal ini, diperlakukan sebagai satu nama. Tanda sisipan (^) juga dapat digunakan sebagai mekanisme kutipan untuk karakter tunggal, misalnya, C:\My^"File dan "C:\My^"File" keduanya merujuk ke file C:\My"File.

[in] nType

Menentukan tipe item, yang harus WNTYPE_FILE.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan WN_SUCCESS. Jika fungsi gagal, fungsi akan mengembalikan kode kesalahan. Panggil SetLastError untuk mengatur kode kesalahan yang diperluas ini, yang mungkin menyertakan kode pengembalian berikut.

Menampilkan kode Deskripsi
WN_BAD_VALUE
 Satu atau beberapa parameter adalah bentuk atau nilai yang tidak terduga.
WN_OUT_OF_MEMORY
 Memori tidak cukup untuk menampilkan kotak dialog.
WN_NET_ERROR
 Terjadi kesalahan jaringan.

Keterangan

Fungsi ini hanya dipanggil pada set properti yang NPGetPropertyText-nya telah menetapkan nama tombol.

Fungsi ini digunakan dalam Pengelola File untuk melihat dan mengubah properti jaringan (misalnya, izin) untuk file pada perangkat jaringan. Jika fungsi ini tidak didukung, Manajer File tidak menyediakan perilaku default apa pun.

Dalam versi antarmuka Penyedia Jaringan ini, lpFileName hanya dapat menunjuk ke nama file. Penyedia jaringan harus mengembalikan WN_BAD_VALUE jika melihat perangkat yang tidak pantas.

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

Lihat juga

NPGetPropertyText

SetLastError