Функция NPGetCaps (npapi.h)

  • Статья

Возвращает сведения о том, какие службы поддерживаются в сети.

Синтаксис

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 Возвращает значение, указывающее тип сети, поддерживаемый поставщиком сети. Слово high содержит тип поставщика, а слово low может содержать подтип. Разработчики, работающие с новыми поставщиками, должны получить новый тип сети от корпорации Майкрософт. Поставщик, который не возвращает правильный тип сети, может привести к непредсказуемым действиям функций 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. Высокие и низкие слова возвращаемого значения содержат основные и дополнительные номера версий спецификации API WNet, поддерживаемые диспетчером учетных данных.

####WNNC_START Возвращает одно из следующих значений, указывающее, может ли поставщик запуститься и когда. MPR будет ожидать самый длительный период ожидания, указанный всеми поставщиками сетей.

Flag Время начала
0x0 Указывает, что поставщик не будет запускаться, например, если он отключен. MPR не будет повторно запускать сетевого поставщика.
Time Указывает время (в миллисекундах) до запуска поставщика.
0xFFFFFFFF Указывает, что поставщик не знает, когда он будет запущен. Если поставщик сети возвращает это значение, MPR использует значение по умолчанию 60 секунд.
0x1 Указывает, что поставщик уже запущен.

####WNNC_USER Возвращает WNNC_USR_GETUSER, если поставщик сети поддерживает функцию NPGetUser .

Комментарии

Когда NPGetCaps возвращает время начала, mpR использует это значение, чтобы определить, когда следует снова запустить всех поставщиков сети. MPR использует самое длинное время начала, возвращаемое вызываемыми поставщиками.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header npapi.h

См. также раздел

NPLogonNotify

NPPasswordChangeNotify