Estructura NETINFOSTRUCT (winnetwk.h)

  • Artículo

La estructura NETINFOSTRUCT contiene información que describe el proveedor de red devuelto por la función WNetGetNetworkInformation .

Sintaxis

typedef struct _NETINFOSTRUCT {
  DWORD     cbStructure;
  DWORD     dwProviderVersion;
  DWORD     dwStatus;
  DWORD     dwCharacteristics;
  ULONG_PTR dwHandle;
  WORD      wNetType;
  DWORD     dwPrinters;
  DWORD     dwDrives;
} NETINFOSTRUCT, *LPNETINFOSTRUCT;

Miembros

cbStructure

Tipo: DWORD

Tamaño, en bytes, de la estructura NETINFOSTRUCT . El autor de la llamada debe proporcionar este valor para indicar el tamaño de la estructura pasada. Tras la devolución, tiene el tamaño de la estructura rellenada.

dwProviderVersion

Tipo: DWORD

Número de versión del software del proveedor de red.

dwStatus

Tipo: DWORD

Estado actual del software del proveedor de red. Este miembro puede ser uno de los siguientes valores.

Valor Significado
NO_ERROR
 La red se está ejecutando.
ERROR_NO_NETWORK
 La red no está disponible.
ERROR_BUSY
 Actualmente, la red no puede atender las solicitudes, pero debería estar disponible en breve. (Este valor suele indicar que la red se está iniciando).

dwCharacteristics

Tipo: DWORD

Características del software del proveedor de red.

Este valor es cero.

Windows Me/98/95: Este miembro puede ser uno o varios de los valores siguientes.

Valor Significado
NETINFO_DLL16
 El proveedor de red se ejecuta como un controlador de red de Windows de 16 bits.
NETINFO_DISKRED
 El proveedor de red requiere un dispositivo de unidad de disco local redirigido para acceder a los sistemas de archivos del servidor.
NETINFO_PRINTERRED
 El proveedor de red requiere un puerto de impresora local redirigido para acceder a los sistemas de archivos del servidor.

dwHandle

Tipo: ULONG_PTR

Identificador de instancia para el proveedor de red o para el controlador de red de Windows de 16 bits.

wNetType

Tipo: WORD

Tipo de red único para la red en ejecución. Este valor asocia recursos a una red específica cuando los recursos son persistentes o se almacenan en vínculos. Puede encontrar una lista completa de los tipos de red en el archivo de encabezado Winnetwk.h.

dwPrinters

Tipo: DWORD

Un conjunto de marcas de bits que indican los números de impresión válidos para redirigir los dispositivos de impresora locales, con el bit de orden bajo correspondiente a LPT1.

Windows Me/98/95: Este valor siempre se establece en –1.

dwDrives

Tipo: DWORD

Un conjunto de marcas de bits que indican los dispositivos de disco local válidos para redirigir las unidades de disco, con el bit de orden bajo correspondiente a A:.

Windows Me/98/95: Este valor siempre se establece en –1.

Comentarios

La estructura NETINFOSTRUCT contiene información que describe la red, como la versión del software del proveedor de red y el estado actual de la red.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado winnetwk.h

Consulte también

WNetGetNetworkInformation

Información general sobre redes de Windows (WNet)

Estructuras de redes de Windows