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