Función NPGetCaps (npapi.h)

Devuelve información sobre qué servicios se admiten en la red.

Sintaxis

DWORD NPGetCaps(
       DWORD ndex
);

Parámetros

ndex

Valor devuelto

La función NPGetCaps devuelve una constante o una máscara de bits, según el valor del parámetro nIndex . Algunos de los valores nIndex hacen que se devuelva una constante. Pero en la mayoría de los casos, el parámetro nIndex especifica qué conjunto de servicios se van a consultar y el valor devuelto es una máscara de bits que indica qué servicios de este conjunto se admiten. En estos casos, un valor devuelto cero indica que no se admite ninguno de los servicios del conjunto.

En la lista siguiente se muestran los valores que nIndex puede contener, cada uno seguido de una descripción de lo que se devuelve para ese valor.

####WNNC_ADMIN Devuelve una máscara que indica qué funciones administrativas admite el proveedor de red. Puede ser uno o varios de los siguientes.

Marca Función admitida
WNNC_ADM_DIRECTORYNOTIFY NPDirectoryNotify
WNNC_ADM_GETDIRECTORYTYPE NPGetDirectoryType

###WNNC_CONNECTION Devuelve una máscara que indica cuál de las funciones de conexión admite el proveedor de red. Puede ser uno o varios de los siguientes.

Marca Función admitida
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) Las conexiones diferidas se admiten con NPAddConnection3.

###WNNC_DIALOG Devuelve una máscara que indica cuál de las funciones del cuadro de diálogo admite el proveedor de red. Puede ser uno o varios de los siguientes.

Marca Función admitida
WNNC_DLG_DEVICEMODE NPDeviceMode
WNNC_DLG_FORMATNETNAME NPFormatNetworkName
WNNC_DLG_GETRESOURCEINFORMATION NPGetResourceInformation
WNNC_DLG_GETRESOURCEPARENT NPGetResourceParent
WNNC_DLG_PERMISSIONEDITOR Esta marca no se usa.
WNNC_DLG_PROPERTYDIALOG NPPropertyDialog y NPGetPropertyText
WNNC_DLG_SEARCHDIALOG NPSearchDialog

####WNNC_ENUMERATION

Devuelve una máscara que indica qué ámbitos de enumeración, si los hay, se admiten. Para obtener más información sobre los ámbitos de enumeración, vea la sección Parámetros del tema de referencia NPOpenEnum. Puede ser uno o varios de los siguientes.

Marca Tipo de enumeración admitido
WNNC_ENUM_GLOBAL (0x00000001) NPOpenEnum se implementa y admite un ámbito de todos los recursos de la red. En otras palabras, NPOpenEnum admite RESOURCE_GLOBALNET.
WNNC_ENUM_LOCAL (0x00000002) NPOpenEnum se implementa y admite un ámbito de todos los recursos conectados actualmente. En otras palabras, NPOpenEnum admite RESOURCE_CONNECTED.
WNNC_ENUM_CONTEXT (0x00000004) NPOpenEnum se implementa y admite un ámbito de todos los recursos asociados al contexto de red actual y predeterminado del usuario. En otras palabras, NPOpenEnum admite RESOURCE_CONTEXT.

Nota Si WNNC_ENUMERATION devuelve una máscara de bits distinto de cero, sabe que el proveedor de red admite NPOpenEnum y puede deducir que el proveedor también admite NPEnumResource y NPCloseEnum. Esto se debe a que también se espera que un proveedor de red que admita NPOpenEnum admita NPEnumResource y NPCloseEnum.

#####WNNC_NET_TYPE Devuelve un valor que indica el tipo de red que admite el proveedor de red. La palabra alta contiene el tipo de proveedor y la palabra baja puede contener un subtipo. Los desarrolladores que trabajan en nuevos proveedores deben obtener un nuevo tipo de red de Microsoft. Un proveedor que no devuelve el tipo de red correcto puede hacer que las funciones WNET se comporten de maneras impredecibles.

El tipo de red puede ser uno de los siguientes.

  • 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 Devuelve WNNC_SPEC_VERSION51. Las palabras altas y bajas del valor devuelto contienen los números de versión principal y secundaria de la especificación de la API de WNet compatible con el administrador de credenciales.

####WNNC_START Devuelve uno de los valores siguientes para indicar si es probable que se inicie el proveedor y cuándo es probable que se inicie. MpR esperará el período de tiempo de espera más largo especificado por todos los proveedores de red.

Marca Hora de inicio
0x0 Indica que el proveedor no se iniciará, por ejemplo, si está deshabilitado. MpR no volverá a intentar iniciar el proveedor de red.
Time Indica la hora, en milisegundos, hasta que se inicia el proveedor.
0xffffffff Indica que el proveedor no sabe cuándo se iniciará. Si el proveedor de red devuelve este valor, MPR usa su valor predeterminado, 60 segundos.
0x1 Indica que el proveedor ya se ha iniciado.

###WNNC_USER Devuelve WNNC_USR_GETUSER si el proveedor de red admite la función NPGetUser .

Comentarios

Cuando NPGetCaps devuelve una hora de inicio, MPR usa este valor para determinar cuándo intentar volver a iniciar todos los proveedores de red. MPR usa la hora de inicio más larga devuelta por los proveedores a los que llamó.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado npapi.h

Consulte también

NPLogonNotify

NPPasswordChangeNotify