Función NPGetConnection (npapi.h)

  • Artículo

Recupera información acerca de una conexión.

Sintaxis

DWORD NPGetConnection(
  [in]      LPWSTR  lpLocalName,
  [out]     LPWSTR  lpRemoteName,
  [in, out] LPDWORD lpnBufferLen
);

Parámetros

[in] lpLocalName

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

[out] lpRemoteName

Puntero a un búfer que recibirá el nombre remoto usado para realizar la conexión. El autor de la llamada asigna este búfer.

[in, out] lpnBufferLen

Puntero al tamaño, en caracteres, del búfer lpRemoteName . 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. 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
 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

La función NPGetConnection solo puede devolver información sobre una conexión de red que está conectada actualmente. Para recuperar información sobre una conexión de red que está desconectada actualmente, use NPGetConnection3.

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