Compartir a través de


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