通过

netINFOSTRUCT 结构 (winnetwk.h)

  • 项目

NETINFOSTRUCT 结构包含描述 WNetGetNetworkInformation 函数返回的网络提供程序的信息。

语法

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

成员

cbStructure

类型：DWORD

NETINFOSTRUCT 结构的大小（以字节为单位）。 调用方必须提供此值以指示传入的结构的大小。 返回后，它已填充结构的大小。

dwProviderVersion

类型：DWORD

网络提供商软件的版本号。

dwStatus

类型：DWORD

网络提供商软件的当前状态。 此成员可以是以下值之一。

值 含义
NO_ERROR
 网络正在运行。
ERROR_NO_NETWORK
 网络不可用。
ERROR_BUSY
 该网络当前无法为请求提供服务，但应该会很快可用。 (此值通常指示网络正在启动。)

dwCharacteristics

类型：DWORD

网络提供商软件的特征。

此值为零。

Windows Me/98/95： 此成员可以是以下一个或多个值。

值 含义
NETINFO_DLL16
 网络提供程序作为 16 位 Windows 网络驱动程序运行。
NETINFO_DISKRED
 网络提供程序需要重定向的本地磁盘驱动器设备才能访问服务器文件系统。
NETINFO_PRINTERRED
 网络提供程序需要重定向的本地打印机端口才能访问服务器文件系统。

dwHandle

类型： ULONG_PTR

网络提供程序或 16 位 Windows 网络驱动程序的实例句柄。

wNetType

类型： WORD

对正在运行的网络唯一的网络类型。 当资源持久化或存储在链接中时，此值将资源与特定网络相关联。 可以在头文件 Winnetwk.h 中找到网络类型的完整列表。

dwPrinters

类型：DWORD

一组位标志，指示用于重定向本地打印机设备的有效打印编号，低序位对应于 LPT1。

Windows Me/98/95： 此值始终设置为 –1。

dwDrives

类型：DWORD

一组位标志，指示用于重定向磁盘驱动器的有效本地磁盘设备，低序位对应于 A：。

Windows Me/98/95： 此值始终设置为 –1。

注解

NETINFOSTRUCT 结构包含描述网络的信息，例如网络提供程序软件的版本和网络的当前状态。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 winnetwk.h

另请参阅

WNetGetNetworkInformation

Windows 网络 (WNet) 概述

Windows 网络结构