Función NPGetConnection3 (npapi.h)

Recupera información sobre una conexión de red, incluso si está desconectada actualmente.

Sintaxis

DWORD NPGetConnection3(
  [in]      LPCWSTR lpLocalName,
  [in]      DWORD   dwLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

Parámetros

[in] lpLocalName

Puntero al nombre del dispositivo local en el que está interesado el autor de la llamada. El proveedor puede suponer que esto es sintácticamente válido.

[in] dwLevel

Valor que especifica si la conexión de red está conectada o desconectada actualmente.

Valor	Significado
WNGETCON_CONNECTED	La conexión de red está conectada.
WNGETCON_DISCONNECTED	La conexión de red está desconectada.

[out] lpBuffer

Puntero void que recibe un búfer que contiene la información solicitada.

[in, out] lpBufferSize

Puntero al tamaño, en caracteres, del búfer lpBuffer . Si se produce un error en la llamada porque el búfer no es lo suficientemente grande, lpBufferSize se establece en el tamaño de búfer necesario.

Valor devuelto

Si la función se ejecuta correctamente, debe devolver WN_SUCCESS.

Si se produce un error en la función, debe devolver uno de los valores siguientes.

Código devuelto	Descripción
WN_NOT_CONNECTED	Este proveedor no redirige el dispositivo especificado por lpLocalName .
WN_MORE_DATA	El búfer era demasiado pequeño para recibir todos los datos.
WN_NO_NETWORK	La red no está presente.

Comentarios

Una conexión de red puede existir en tres estados: conectado, desconectado y no disponible. La función NPGetConnection3 no puede recuperar información sobre las conexiones de red que no están disponibles actualmente. Sin embargo, puede recuperar información sobre las conexiones de red que están desconectadas actualmente porque Windows almacena la información de conexión.

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