傳回網路上支援哪些服務的相關信息。
語法
DWORD NPGetCaps(
DWORD ndex
);
參數
ndex
返回值
NPGetCaps 函式會傳回常數或位遮罩，視 nIndex 參數的值而定。 一些 nIndex 值會導致傳回常數。 但在大部分情況下， nIndex 參數會指定要查詢的服務集，而傳回的值是位遮罩，指出支援此集中的服務。 在這些情況下，零傳回值表示不支援集合中的任何服務。
下列清單顯示 nIndex 可能包含的值，每個值後面接著針對該值傳回的內容的描述。
####WNNC_ADMIN 傳回遮罩，指出網路提供者支援哪些管理功能。 這可以是下列一或多項。
| Flag | 支援的功能 |
|---|---|
| WNNC_ADM_DIRECTORYNOTIFY | NPDirectoryNotify |
| WNNC_ADM_GETDIRECTORYTYPE | NPGetDirectoryType |
####WNNC_CONNECTION 傳回遮罩，指出網路提供者支援哪些連線功能。 這可以是下列一或多項。
| Flag | 支援的功能 |
|---|---|
| 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） | NPAddConnection3 支援延遲連線。 |
####WNNC_DIALOG 傳回遮罩，指出網路提供者支援的對話方塊函式。 這可以是下列一或多項。
| Flag | 支援的功能 |
|---|---|
| WNNC_DLG_DEVICEMODE | NPDeviceMode |
| WNNC_DLG_FORMATNETNAME | NPFormatNetworkName |
| WNNC_DLG_GETRESOURCEINFORMATION | NPGetResourceInformation |
| WNNC_DLG_GETRESOURCEPARENT | NPGetResourceParent |
| WNNC_DLG_PERMISSIONEDITOR | 不會使用此旗標。 |
| WNNC_DLG_PROPERTYDIALOG | NPPropertyDialog 和 NPGetPropertyText |
| WNNC_DLG_SEARCHDIALOG | NPSearchDialog |
####WNNC_ENUMERATION
傳回遮罩，指出支援哪些列舉範圍 （如果有的話）。 如需列舉範圍的詳細資訊，請參閱參考主題 NPOpenEnum 中的 參數 一節。 這可以是下列一或多項。
| Flag | 支援的列舉類型 |
|---|---|
| WNNC_ENUM_GLOBAL （0x00000001） | NPOpenEnum 已實作，並支援網路上所有資源的範圍。 換句話說，NPOpenEnum 支援RESOURCE_GLOBALNET。 |
| WNNC_ENUM_LOCAL （0x00000002） | NPOpenEnum 已實作，並支援所有目前連線資源的範圍。 換句話說，NPOpenEnum 支援RESOURCE_CONNECTED。 |
| WNNC_ENUM_CONTEXT （0x00000004） | NPOpenEnum 已實作，並支援與使用者目前和預設網路內容相關聯的所有資源範圍。 換句話說，NPOpenEnum 支援RESOURCE_CONTEXT。 |
便條 如果WNNC_ENUMERATION傳回非零位遮罩，您知道網路提供者支援 NPOpenEnum ，而且可以推斷提供者也支援 NPEnumResource 和 NPCloseEnum。 這是因為支援 NPOpenEnum 的網路提供者也預期會支援 NPEnumResource 和 NPCloseEnum。
####WNNC_NET_TYPE 傳回一個值，指出網路提供者支援的網路類型。 高字包含提供者類型，而低字可能包含子類型。 正在開發新提供者的開發人員應該從 Microsoft 取得新的網路類型。 未傳回正確網路類型的提供者可能會導致 WNET 函式以無法預期的方式運作。
網路類型可以是下列其中一種。
- 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 雷迪爾
- 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 傳回WNNC_SPEC_VERSION51。 傳回值的高字和低字包含認證管理員支援之 WNet API 規格的主要和次要版本號碼。
####WNNC_START 傳回下列其中一個值，以指出提供者是否以及何時可能啟動。 MPR 將等待所有網路提供者指定的最長逾時期間。
| Flag | 開始時間 |
|---|---|
| 0x0 | 表示提供者不會啟動，例如，如果它已停用。 MPR 不會重試啟動網路提供者。 |
| Time | 指出提供者啟動之前的時間 （以毫秒為單位）。 |
| 0xFFFFFFFF | 表示提供者不知道何時啟動。 如果網路提供者傳回此值，MPR 會使用其預設值 60 秒。 |
| 0x1 | 表示提供者已啟動。 |
####WNNC_USER 如果網路提供者支援 NPGetUser 函式，則會傳回WNNC_USR_GETUSER。
備註
當 NPGetCaps 傳回開始時間時，MPR 會使用此值來判斷何時嘗試再次啟動所有網路提供者。 MPR 會使用其呼叫的提供者所傳回的最長開始時間。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| Header | npapi.h |
| Library | davclnt.lib |