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.

Sinalizador Função com suporte
WNNC_ADM_DIRECTORYNOTIFY NPDirectoryNotify
WNNC_ADM_GETDIRECTORYTYPE NPGetDirectoryType

####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.

Sinalizador Função com suporte
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) Há suporte para conexões adiadas com NPAddConnection3.

####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.

Sinalizador Função com suporte
WNNC_DLG_DEVICEMODE NPDeviceMode
WNNC_DLG_FORMATNETNAME NPFormatNetworkName
WNNC_DLG_GETRESOURCEINFORMATION NPGetResourceInformation
WNNC_DLG_GETRESOURCEPARENT NPGetResourceParent
WNNC_DLG_PERMISSIONEDITOR Esse sinalizador não é usado.
WNNC_DLG_PROPERTYDIALOG NPPropertyDialog e NPGetPropertyText
WNNC_DLG_SEARCHDIALOG NPSearchDialog

####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.

Sinalizador Tipo de enumeração com suporte
WNNC_ENUM_GLOBAL (0x00000001) O NPOpenEnum é implementado e dá suporte a um escopo de todos os recursos na rede. Em outras palavras, NPOpenEnum dá suporte a RESOURCE_GLOBALNET.
WNNC_ENUM_LOCAL (0x00000002) O NPOpenEnum é implementado e dá suporte a um escopo de todos os recursos conectados no momento. Em outras palavras, NPOpenEnum dá suporte a RESOURCE_CONNECTED.
WNNC_ENUM_CONTEXT (0x00000004) O NPOpenEnum é implementado e dá suporte a um escopo de todos os recursos associados ao contexto de rede atual e padrão do usuário. Em outras palavras, NPOpenEnum dá suporte a RESOURCE_CONTEXT.

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.

Sinalizador Hora de início
0x0 Indica que o provedor não será iniciado, por exemplo, se ele estiver desabilitado. O MPR não tentará iniciar novamente o provedor de rede.
Hora Indica a hora, em milissegundos, até que o provedor seja iniciado.
0xFFFFFFFF Indica que o provedor não sabe quando será iniciado. Se o provedor de rede retornar esse valor, o MPR usará seu valor padrão, 60 segundos.
0x1 Indica que o provedor já foi iniciado.

####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

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho npapi.h

Confira também

NPLogonNotify

NPPasswordChangeNotify