返回有关网络上支持哪些服务的信息。
Syntax
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 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 将等待所有网络提供商指定的最长超时期限。
| Flag | 开始时间 |
|---|---|
| 0x0 | 指示提供程序不会启动，例如，如果禁用提供程序。 MPR 不会重试启动网络提供程序。 |
| Time | 指示提供程序开始前的时间（以毫秒为单位）。 |
| 0xFFFFFFFF | 指示提供程序不知道何时启动。 如果网络提供程序返回此值，MPR 将使用其默认值 60 秒。 |
| 0x1 | 指示提供程序已启动。 |
####WNNC_USER 如果网络提供程序支持 NPGetUser 函数，则返回WNNC_USR_GETUSER。
注解
NPGetCaps 返回开始时间时，MPR 使用此值来确定何时尝试再次启动所有网络提供程序。 MPR 使用调用的提供程序返回的最长开始时间。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows XP [仅限桌面应用] |
| 支持的最低服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows操作系统 |
| Header | npapi.h |
| Library | davclnt.lib |