Función MultinetGetConnectionPerformanceW (winnetwk.h)

La función MultinetGetConnectionPerformance devuelve información sobre el rendimiento esperado de una conexión usada para acceder a un recurso de red.

Sintaxis

DWORD MultinetGetConnectionPerformanceW(
  [in]  LPNETRESOURCEW         lpNetResource,
  [out] LPNETCONNECTINFOSTRUCT lpNetConnectInfoStruct
);

Parámetros

[in] lpNetResource

Puntero a una estructura de NETRESOURCE que especifica el recurso de red. Los miembros siguientes tienen significados específicos en este contexto.

Miembro	Significado
lpLocalName	Puntero a un búfer que especifica un dispositivo local, como "F:" o "LPT1", que se redirige a un recurso de red que se va a consultar. Si este miembro es NULL o una cadena vacía, el recurso de red se especifica en el miembro lpRemoteName. Si esta marca especifica un dispositivo local, se omite lpRemoteName.
lpRemoteName	Puntero a un recurso de red que se va a consultar. El recurso debe tener actualmente una conexión establecida. Por ejemplo, si el recurso es un archivo en un servidor de archivos, tener el archivo abierto garantizará la conexión.
lpProvider	Normalmente se establece en NULL, pero puede ser un puntero al propietario (proveedor) del recurso si se conoce la red en la que reside el recurso. Si el miembro lpProvider no es NULL, el sistema intenta devolver información solo sobre la red con nombre.

[out] lpNetConnectInfoStruct

Puntero a la estructura NETCONNECTINFOSTRUCT que recibe los datos.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es un código de error del sistema , como uno de los valores siguientes.

Código devuelto	Descripción
ERROR_NOT_SUPPORTED	El recurso de red no proporciona esta información.
ERROR_NOT_CONNECTED	El miembro lpLocalName del NETRESOURCE estructura a la que apunta el parámetro lpNetResource no especifica un dispositivo redirigido o el miembro lpRemoteName no especifica el nombre de un recurso que está conectado actualmente.
ERROR_NO_NET_OR_BAD_PATH	No se pudo completar la operación, ya sea porque no se ha iniciado un componente de red o porque no se reconoce el nombre del recurso especificado.
ERROR_BAD_DEVICE	El dispositivo local especificado por el miembro lpLocalName no es válido.
ERROR_BAD_NET_NAME	No se encuentra el nombre de red. Este error se devuelve si el miembro lpLocalName del de NETRESOURCE a la que apunta el parámetro lpNetResource era NULL y el miembro lpRemoteName de la estructura de NETRESOURCE a la que apunta el lpNetResource de también era o NULL o no podía reconocerla ninguna red.
ERROR_INVALID_ADDRESS	Intento de acceder a una dirección no válida. Este error se devuelve si los parámetros de lpNetResource o lpNetConnectInfoStruct eran null.
ERROR_INVALID_PARAMETER	Se pasó un parámetro incorrecto. Este error se devuelve si el parámetro lpNetConnectInfoStruct no apunta a una estructura NETCONNECTINFOSTRUCT en la que el miembro cbStructure se rellena con el tamaño de estructura adecuado.
ERROR_NO_NETWORK	La red no está disponible.
ERROR_EXTENDED_ERROR	Error específico de la red. Para obtener una descripción del error, llame a WNetGetLastError.

Observaciones

La función multinetGetConnectionPerformance devuelve la información de una estructura NETCONNECTINFOSTRUCT de .

La información devuelta por la función MultinetGetConnectionPerformance es solo una estimación. El tráfico de red y el enrutamiento pueden afectar a la precisión de los resultados devueltos.

Tenga en cuenta que la función MultinetGetConnectionPerformance solo se puede usar para solicitar información de un dispositivo local que se redirige a un recurso de red o para un recurso de red al que hay actualmente una conexión.

Si se especifica una ruta de acceso UNC en el lpRemoteName miembro del NETRESOURCE estructura apuntada por el parámetro lpNetResource, el miembro lpRemoteName debe ser un nombre de directorio, no un nombre de archivo.

Una manera típica de usar esta función sería abrir un archivo en un servidor de red (lo que garantizaría que haya una conexión con el archivo), llamar a esta función y usar los resultados para tomar decisiones sobre cómo administrar la E/S de archivos. Por ejemplo, puede decidir si leer todo el archivo en un archivo temporal en el cliente o acceder directamente al archivo en el servidor.

Nota

El encabezado winnetwk.h define MultinetGetConnectionPerformance como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winnetwk.h
biblioteca de	Mpr.lib
DLL de	Mpr.dll

Consulte también

NETCONNECTINFOSTRUCT

NETRESOURCE

redes de Windows (WNet)

funciones de red de Windows