Compartir a través de


Función NPGetConnection3 (npapi.h)

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

Syntax

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 es válido sintácticamente.

[in] dwLevel

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

Importancia Meaning
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 de retorno Description
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.

Observaciones

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 actualmente no están disponibles. 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

Requirement Importancia
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
Header npapi.h
Library nanosrv.lib