Función MultinetGetConnectionPerformanceA (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 MultinetGetConnectionPerformanceA(
[in] LPNETRESOURCEA lpNetResource,
[out] LPNETCONNECTINFOSTRUCT lpNetConnectInfoStruct
);
Parámetros
[in] lpNetResource
Puntero a una estructura NETRESOURCE que especifica el recurso de red. Los miembros siguientes tienen significados específicos en este contexto.
[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 siguientes valores.
| Código devuelto | Descripción |
|---|---|
|
El recurso de red no proporciona esta información. |
|
El miembro lpLocalName de la estructura NETRESOURCE 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. |
|
No se pudo completar la operación, ya sea porque no se inicia un componente de red o porque no se reconoce el nombre de recurso especificado. |
|
El dispositivo local especificado por el miembro lpLocalName no es válido. |
|
No se encuentra el nombre de red especificado. Este error se devuelve si el miembro lpLocalName de la estructura NETRESOURCE a la que apunta el parámetro lpNetResource era NULL y el miembro lpRemoteName de la estructura NETRESOURCE a la que apunta el lpNetResource también era o NULL o no podía reconocerse por ninguna red. |
|
Intento de acceder a una dirección no válida. Este error se devuelve si los parámetros lpNetResource o lpNetConnectInfoStruct eran NULL. |
|
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. |
|
La red no está disponible. |
|
Error específico de la red. Para obtener una descripción del error, llame a WNetGetLastError. |
Comentarios
La función MultinetGetConnectionPerformance devuelve la información de una estructura NETCONNECTINFOSTRUCT .
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 para 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 miembro lpRemoteName de la estructura NETRESOURCE a la que apunta 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winnetwk.h |
| Library | Mpr.lib |
| Archivo DLL | Mpr.dll |