Função NPGetCaps (npapi.h)

Retorna informações sobre quais serviços têm suporte na rede.

Sintaxe

DWORD NPGetCaps(
       DWORD ndex
);

Parâmetros

ndex

Valor retornado

A função NPGetCaps retorna uma constante ou uma máscara de bits, dependendo do valor do parâmetro nIndex . Alguns dos valores nIndex fazem com que uma constante seja retornada. Mas, na maioria dos casos, o parâmetro nIndex especifica qual conjunto de serviços consultar e o valor retornado é uma máscara de bits que indica quais serviços nesse conjunto têm suporte. Nesses casos, um valor de retorno zero indica que nenhum dos serviços no conjunto tem suporte.

A lista a seguir mostra os valores que nIndex pode conter, cada um seguido por uma descrição do que é retornado para esse valor.

####WNNC_ADMIN Retorna uma máscara que indica quais das funções administrativas o provedor de rede dá suporte. Isso pode ser um ou mais dos seguintes.

####WNNC_CONNECTION Retorna uma máscara que indica qual das funções de conexão o provedor de rede dá suporte. Isso pode ser um ou mais dos seguintes.

####WNNC_DIALOG Retorna uma máscara que indica qual das funções da caixa de diálogo o provedor de rede dá suporte. Isso pode ser um ou mais dos seguintes.

####WNNC_ENUMERATION

Retorna uma máscara que indica quais escopos de enumeração, se houver, têm suporte. Para obter mais informações sobre escopos de enumeração, consulte a seção Parâmetros no tópico de referência NPOpenEnum. Isso pode ser um ou mais dos seguintes.

Nota Se WNNC_ENUMERATION retornar uma máscara de bits diferente de zero, você sabe que o provedor de rede dá suporte a NPOpenEnum e pode inferir que o provedor também dá suporte a NPEnumResource e NPCloseEnum. Isso ocorre porque um provedor de rede que dá suporte a NPOpenEnum também é esperado para dar suporte a NPEnumResource e NPCloseEnum.

####WNNC_NET_TYPE Retorna um valor que indica o tipo de rede compatível com o provedor de rede. A palavra alta contém o tipo de provedor e a palavra baixa pode conter um subtipo. Os desenvolvedores que estão trabalhando em novos provedores devem obter um novo tipo de rede da Microsoft. Um provedor que não retorna o tipo de rede correto pode fazer com que as funções WNET se comportem de maneiras imprevisíveis.

O tipo de rede pode ser um dos seguintes.

• 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 Retorna WNNC_SPEC_VERSION51. As palavras altas e baixas do valor retornado contêm os números de versão principal e secundária da especificação da API WNet compatível com o gerenciador de credenciais.

####WNNC_START Retorna um dos valores a seguir para indicar se e quando o provedor provavelmente será iniciado. O MPR aguardará o período de tempo limite mais longo especificado por todos os provedores de rede.

####WNNC_USER Retornará WNNC_USR_GETUSER se o provedor de rede der suporte à função NPGetUser .

Comentários

Quando uma hora de início é retornada por NPGetCaps, o MPR usa esse valor para determinar quando tentar iniciar todos os provedores de rede novamente. O MPR usa a hora de início mais longa retornada pelos provedores chamados.

Requisitos

Confira também

NPLogonNotify

NPPasswordChangeNotify