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 |