NPGetCaps 函式 (npapi.h)
傳回網路上支援哪些服務的相關信息。
語法
DWORD NPGetCaps(
DWORD ndex
);
參數
ndex
傳回值
NPGetCaps 函式會根據 nIndex 參數的值傳回常數或位掩碼。 其中一些 nIndex 值會導致傳回常數。 但在大部分情況下， nIndex 參數會指定要查詢的服務集，而傳回的值是位掩碼，表示支援此集合中的哪些服務。 在這些情況下，零傳回值表示不支援集合中的任何服務。
下列清單顯示 nIndex 可能包含的值，後面接著針對該值傳回的內容描述。
####WNNC_ADMIN 傳回遮罩，指出網路提供者支持的系統管理功能。 這可以是下列其中一或多個。
| 旗標 | 支援的函式 |
|---|---|
| WNNC_ADM_DIRECTORYNOTIFY | NPDirectoryNotify |
| WNNC_ADM_GETDIRECTORYTYPE | NPGetDirectoryType |
####WNNC_CONNECTION 傳回遮罩，指出網路提供者支持的連線功能。 這可以是下列其中一或多個。
| 旗標 | 支援的函式 |
|---|---|
| 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 傳回遮罩，指出網路提供者支持的對話框功能。 這可以是下列其中一或多個。
| 旗標 | 支援的函式 |
|---|---|
| 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 參考主題中的 Parameters 一節。 這可以是下列其中一或多個。
| 旗標 | 支援的列舉類型 |
|---|---|
| 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 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 傳回WNNC_SPEC_VERSION51。 傳回值的高和低字包含認證管理員所支援的 WNet API 規格主要和次要版本號碼。
####WNNC_START 傳回下列其中一個值，指出提供者是否可能啟動和何時啟動。 MPR 會等候所有網路提供者所指定的最長逾時期間。
| 旗標 | 開始時間 |
|---|---|
| 0x0 | 表示提供者不會啟動，例如，如果它已停用。 MPR 不會重試啟動網路提供者。 |
| 時間 | 指出提供者開始之前的時間，以毫秒為單位。 |
| 0xFFFFFFFF | 表示提供者不知道何時會啟動。 如果網路提供者傳回此值，MPR 會使用其預設值 60 秒。 |
| 0x1 | 表示提供者已經啟動。 |
####WNNC_USER 如果網络提供者支援 NPGetUser 函式，則會傳回WNNC_USR_GETUSER。
備註
當 NPGetCaps 傳回開始時間時，MPR 會使用此值來判斷何時嘗試再次啟動所有網路提供者。 MPR 會使用呼叫的提供者所傳回的最長開始時間。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | npapi.h |