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