共用方式為

NETRESOURCEA 結構 （winnetwk.h）

  • 發行項

下列結構包含網路資源的相關信息。 它由數個網路提供者函式使用，包括 NPOpenEnum 和 NPAddConnection。

語法

typedef struct _NETRESOURCEA {
  DWORD dwScope;
  DWORD dwType;
  DWORD dwDisplayType;
  DWORD dwUsage;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  LPSTR lpComment;
  LPSTR lpProvider;
} NETRESOURCEA, *LPNETRESOURCEA;

成員

dwScope

表示列舉的範圍。 這可以是下列其中一個值。

價值 意義
RESOURCE_CONNECTED
 目前網路資源的連線。
RESOURCE_GLOBALNET
 所有網路資源。 這些可能或可能未連線。
RESOURCE_CONTEXT
 與使用者目前和預設網路內容相關聯的網路資源。 這的意義是提供者特定的。

dwType

指出資源類型。 這可以是下列其中一個值。

價值 意義
RESOURCETYPE_DISK
 資源是共用磁碟區。
RESOURCETYPE_PRINT
 資源是共用印表機。
RESOURCETYPE_ANY
 資源會比對多個類型，例如列印和磁碟資源的容器，或不是列印或磁碟的資源。

dwDisplayType

由提供者設定，指出使用者介面應該用來表示此資源的顯示類型。 定義下列類型。

價值 意義
RESOURCEDISPLAYTYPE_NETWORK
 資源是網路提供者。
RESOURCEDISPLAYTYPE_DOMAIN
 資源是伺服器集合。
RESOURCEDISPLAYTYPE_SERVER
 資源是伺服器。
RESOURCEDISPLAYTYPE_SHARE
 資源是共享點。
RESOURCEDISPLAYTYPE_DIRECTORY
 資源是目錄。
RESOURCEDISPLAYTYPE_GENERIC
 資源類型未指定。 未指定資源類型的網路提供者會使用此值。

dwUsage

位掩碼，指出如何列舉資源的相關信息。 只有當 dwScope 設定為 RESOURCE_GLOBALNET 時，才會定義它。 dwUsage 欄位可以包含下列一或多個旗標。

價值 意義
RESOURCEUSAGE_CONNECTABLE
 您可以呼叫 NPAddConnection來連線到資源。 如果 dwType 是RESOURCETYPE_DISK，則在聯機到資源之後，您可以使用文件系統 API，例如 FindFirstFile，以及 FindNextFile，列舉資源所包含的任何檔案和目錄。
RESOURCEUSAGE_CONTAINER
 資源是其他資源的容器，可透過 NPOpenEnum、NPEnumResource和 NPCloseEnum 函式來列舉。

不過，在進行列舉時，容器可能會是空的。 換句話說，第一次呼叫 NPEnumResource 可能會傳回WN_NO_MORE_ENTRIES。

lpLocalName

如果 dwScope 是RESOURCE_CONNECTED，lpLocalName 字段會包含重新導向裝置的名稱。 如果連線是無裝置連線，此欄位會包含 null 。

如果 dwScope 未設定為 RESOURCE_CONNECTED，則此欄位未定義。

lpRemoteName

如果列舉專案是網路資源，此欄位會包含遠端網路名稱。 然後，如果 dwUsage 設定 為RESOURCEUSAGE_CONNECTABLE，此名稱可能會傳遞至 npAddConnection，以建立網路連線。 如果列舉專案是目前的連線，此字段會參考 lpLocalName 所連線的遠端網路名稱。

lpComment

可以是與列舉項目相關聯的任何提供者提供的批注。

lpProvider

指定擁有這個列舉專案的提供者名稱。

言論

注意

winnetwk.h 標頭會將 NETRESOURCE 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 winnetwk.h