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

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

Синтаксис

DWORD NPGetCaps(
       DWORD ndex
);

Параметры

ndex

Возвращаемое значение

Функция NPGetCaps возвращает константу или битовую маску в зависимости от значения параметра nIndex . Некоторые значения nIndex приводят к возврату константы. Но в большинстве случаев параметр nIndex указывает, к какому набору служб следует выполнить запрос, а возвращаемое значение представляет собой битовую маску, указывающую, какие службы в этом наборе поддерживаются. В таких случаях нулевое возвращаемое значение указывает, что ни одна из служб в наборе не поддерживается.

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

####WNNC_ADMIN Возвращает маску, указывающую, какие из административных функций поддерживает поставщик сети. Это может быть один или несколько из следующих вариантов.

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

####WNNC_DIALOG Возвращает маску, указывающую, какую из функций диалогового окна поддерживает поставщик сети. Это может быть один или несколько из следующих вариантов.

####WNNC_ENUMERATION

Возвращает маску, указывающую, какие области перечисления , если таковые имеются, поддерживаются. Дополнительные сведения об областях перечисления см. в разделе Параметры в справочном разделе NPOpenEnum. Это может быть один или несколько из следующих вариантов.

Примечание Если 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 будет ожидать самый длительный период ожидания, указанный всеми поставщиками сетей.

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

Комментарии

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

Требования

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

NPLogonNotify

NPPasswordChangeNotify