Fungsi NPGetCaps (npapi.h)
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 |