Fungsi NPPropertyDialog (npapi.h)

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.

[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.

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

Lihat juga

NPGetPropertyText

SetLastError