共用方式為

(winnetwk.h) NETINFOSTRUCT 結構

  • 發行項

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 網路結構