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 中的参数部分。 这可以是以下一项或多项。
| 标志 | 支持的枚举类型 |
|---|---|
| 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 |