Fungsi NPGetCaps (npapi.h)

  • Artikel

Mengembalikan informasi tentang layanan mana yang didukung di jaringan.

Sintaks

DWORD NPGetCaps(
       DWORD ndex
);

Parameter

ndex

Nilai kembali

Fungsi NPGetCaps mengembalikan konstanta atau bitmask, tergantung pada nilai parameter nIndex . Beberapa nilai nIndex menyebabkan konstanta dikembalikan. Tetapi dalam kebanyakan kasus, parameter nIndex menentukan kumpulan layanan mana yang akan dikueri, dan nilai yang dikembalikan adalah bitmask yang menunjukkan layanan mana dalam set ini yang didukung. Dalam kasus ini, nilai pengembalian nol menunjukkan bahwa tidak ada layanan dalam set yang didukung.

Daftar berikut ini memperlihatkan nilai yang mungkin dimuat nIndex , masing-masing diikuti oleh deskripsi tentang apa yang dikembalikan untuk nilai tersebut.

####WNNC_ADMIN Mengembalikan masker yang menunjukkan fungsi administratif mana yang didukung penyedia jaringan. Ini bisa menjadi satu atau beberapa hal berikut ini.

Bendera Fungsi didukung
WNNC_ADM_DIRECTORYNOTIFY NPDirectoryNotify
WNNC_ADM_GETDIRECTORYTYPE NPGetDirectoryType

####WNNC_CONNECTION Mengembalikan masker yang menunjukkan fungsi koneksi mana yang didukung penyedia jaringan. Ini bisa menjadi satu atau beberapa hal berikut ini.

Bendera Fungsi didukung
WNNC_CON_ADDCONECTION (0x00000001) NPAddConnection
WNNC_CON_CANCELCONNECTION (0x00000002) NPCancelConnection
WNNC_CON_GETCONNECTIONS (0x00000004) NPGetConnection
WNNC_CON_ADDCONECTION3 (0x00000008) NPAddConnection3
WNNC_CON_GETPERFORMANCE (0x00000040) NPGetConnectionPerformance
WNNC_CON_DEFER (0x00000080) Koneksi yang ditangguhkan didukung dengan NPAddConnection3.

####WNNC_DIALOG Menampilkan masker yang menunjukkan kotak dialog mana yang didukung penyedia jaringan. Ini bisa menjadi satu atau beberapa hal berikut ini.

Bendera Fungsi didukung
WNNC_DLG_DEVICEMODE NPDeviceMode
WNNC_DLG_FORMATNETNAME NPFormatNetworkName
WNNC_DLG_GETRESOURCEINFORMATION NPGetResourceInformation
WNNC_DLG_GETRESOURCEPARENT NPGetResourceParent
WNNC_DLG_PERMISSIONEDITOR Bendera ini tidak digunakan.
WNNC_DLG_PROPERTYDIALOG NPPropertyDialog dan NPGetPropertyText
WNNC_DLG_SEARCHDIALOG NPSearchDialog

####WNNC_ENUMERATION

Mengembalikan masker yang menunjukkan cakupan enumerasi mana, jika ada, yang didukung. Untuk informasi selengkapnya tentang cakupan enumerasi, lihat bagian Parameter dalam topik referensi NPOpenEnum. Ini bisa menjadi satu atau beberapa hal berikut ini.

Bendera Jenis enumerasi didukung
WNNC_ENUM_GLOBAL (0x00000001) NPOpenEnum diimplementasikan dan mendukung cakupan semua sumber daya di jaringan. Dengan kata lain, NPOpenEnum mendukung RESOURCE_GLOBALNET.
WNNC_ENUM_LOCAL (0x00000002) NPOpenEnum diimplementasikan dan mendukung cakupan semua sumber daya yang saat ini terhubung. Dengan kata lain, NPOpenEnum mendukung RESOURCE_CONNECTED.
WNNC_ENUM_CONTEXT (0x00000004) NPOpenEnum diimplementasikan dan mendukung cakupan semua sumber daya yang terkait dengan konteks jaringan pengguna saat ini dan default. Dengan kata lain, NPOpenEnum mendukung RESOURCE_CONTEXT.

Catatan Jika WNNC_ENUMERATION mengembalikan bitmask bukan nol, Anda tahu bahwa penyedia jaringan mendukung NPOpenEnum dan dapat menyimpulkan bahwa penyedia juga mendukung NPEnumResource dan NPCloseEnum. Ini karena penyedia jaringan yang mendukung NPOpenEnum juga diharapkan mendukung NPEnumResource dan NPCloseEnum.

####WNNC_NET_TYPE Mengembalikan nilai yang menunjukkan jenis jaringan yang didukung penyedia jaringan. Kata tinggi berisi jenis penyedia, dan kata rendah mungkin berisi subjenis. Pengembang yang bekerja pada penyedia baru harus mendapatkan jenis jaringan baru dari Microsoft. Penyedia yang tidak mengembalikan jenis jaringan yang benar dapat menyebabkan fungsi WNET berakibat dengan cara yang tidak dapat diprediksi.

Jenis jaringan bisa menjadi salah satu dari berikut ini.

  • WNNC_NET_10NET
  • WNNC_NET_INTERGRAPH
  • WNNC_NET_3IN1
  • WNNC_NET_LANMAN
  • WNNC_NET_9TILES
  • WNNC_NET_LANSTEP
  • WNNC_NET_APPLETALK
  • WNNC_NET_LANTASTIC
  • WNNC_NET_AS400
  • WNNC_NET_LIFENET
  • WNNC_NET_BMC
  • WNNC_NET_LOCUS
  • WNNC_NET_BWNFS
  • WNNC_NET_MASFAX
  • WNNC_NET_CLEARCASE
  • WNNC_NET_MSNET
  • WNNC_NET_COGENT
  • WNNC_NET_NETWARE
  • WNNC_NET_CSC
  • WNNC_NET_OBJECT_DIRE
  • WNNC_NET_DCE
  • WNNC_NET_PATHWORKS
  • WNNC_NET_DECOREB
  • WNNC_NET_POWERLAN
  • WNNC_NET_DISTENCT
  • WNNC_NET_PROTSTOR
  • WNNC_NET_EXTENDNET
  • WNNC_NET_RDR2SAMPLE
  • WNNC_NET_FARALLON
  • WNNC_NET_SHIVA
  • WNNC_NET_FJ REDIR
  • WNNC_NET_SUN_PC_NFS
  • WNNC_NET_FRONTIER
  • WNNC_NET_SYMFONET
  • WNNC_NET_FTP_NFS
  • WNNC_NET_TWINS
  • WNNC_NET_HOB_NFS
  • WNNC_NET_VINES
  • WNNC_NET_IBMAL

####WNNC_SPEC_VERSION Mengembalikan WNNC_SPEC_VERSION51. Kata-kata tinggi dan rendah dari nilai pengembalian berisi nomor versi utama dan minor dari spesifikasi WNet API yang didukung oleh manajer kredensial.

####WNNC_START Mengembalikan salah satu nilai berikut untuk menunjukkan apakah dan kapan penyedia kemungkinan akan memulai. MPR akan menunggu periode waktu habis terpanjang yang ditentukan oleh semua penyedia jaringan.

Bendera Waktu mulai
0x0 Menunjukkan penyedia tidak akan memulai, misalnya, jika dinonaktifkan. MPR tidak akan mencoba lagi memulai penyedia jaringan.
Waktu Menunjukkan waktu, dalam milidetik, hingga penyedia dimulai.
0xFFFFFFFF Menunjukkan bahwa penyedia tidak tahu kapan akan dimulai. Jika penyedia jaringan mengembalikan nilai ini, MPR menggunakan nilai defaultnya, 60 detik.
0x1 Menunjukkan bahwa penyedia sudah dimulai.

####WNNC_USER Mengembalikan WNNC_USR_GETUSER jika penyedia jaringan mendukung fungsi NPGetUser .

Keterangan

Ketika waktu mulai dikembalikan oleh NPGetCaps, MPR menggunakan nilai ini untuk menentukan kapan harus mencoba memulai semua penyedia jaringan lagi. MPR menggunakan waktu mulai terpanjang yang dikembalikan oleh penyedia yang disebutnya.

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

NPLogonNotify

NPPasswordChangeNotify