Función NPGetConnectionPerformance (npapi.h)

  • Artículo

Devuelve información sobre el rendimiento esperado de una conexión utilizada para acceder a un recurso de red. La solicitud solo puede ser para un recurso de red que esté conectado actualmente.

Sintaxis

DWORD NPGetConnectionPerformance(
  [in]  LPCWSTR                lpRemoteName,
  [out] LPNETCONNECTINFOSTRUCT lpNetConnectInfo
);

Parámetros

[in] lpRemoteName

Puntero al nombre local o al nombre remoto de un recurso conectado.

[out] lpNetConnectInfo

Puntero a una estructura NETCONNECTINFOSTRUCT , rellenada por el proveedor de red si el proveedor tiene una conexión al recurso de red. Todos los demás campos de esta estructura, excepto el campo cbStructure , se rellenan con ceros antes de que el MPR pase la solicitud a los proveedores de red. Como resultado, el proveedor tiene que escribir solo en campos para los que tiene información disponible. Además, para los valores de velocidad, un valor de 1 significa que el rendimiento es mejor que se puede representar en la unidad.

La información devuelta puede ser una estimación. Si la red no puede obtener información sobre el recurso de la red, puede devolver información sobre el adaptador de red y su rendimiento asociado y, a continuación, establecer el campo dwFlags en consecuencia.

Valor devuelto

Si la función se ejecuta correctamente, debe devolver WN_SUCCESS. De lo contrario, debe devolver un código de error, que puede ser uno de los siguientes.

Código devuelto Descripción
WN_NOT_CONNECTED
 lpRemoteName no es un recurso de red conectado.
WN_NO_NETWORK
 La red no está presente.

Requisitos

   
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