Fungsi NPGetCaps (npapi.h)

Mengembalikan informasi tentang layanan mana yang didukung di jaringan.

Syntax

DWORD NPGetCaps(
       DWORD ndex
);

Parameter-parameternya

ndex

Mengembalikan nilai

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

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

Flag	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 Mengembalikan masker yang menunjukkan mana dari kotak dialog yang didukung penyedia jaringan. Ini bisa menjadi satu atau beberapa hal berikut ini.

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

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

Nota Jika WNNC_ENUMERATION mengembalikan bitmask nonzero, 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 mengerjakan penyedia baru harus mendapatkan jenis jaringan baru dari Microsoft. Penyedia yang tidak mengembalikan jenis jaringan yang benar dapat menyebabkan fungsi WNET bertingkah 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 dimulai. MPR akan menunggu periode waktu habis terlama yang ditentukan oleh semua penyedia jaringan.

Flag	Waktu mulai
0x0	Menunjukkan penyedia tidak akan memulai, misalnya, jika dinonaktifkan. MPR tidak akan mencoba lagi memulai penyedia jaringan.
Time	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 .

Komentar

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]
Platform Target	Windows
Header	npapi.h
Library	davclnt.lib

Lihat juga

NPLogonNotify

NPPasswordChangeNotify