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
表示列舉的範圍。 這可以是下列其中一個值。
值 | 意義 |
---|---|
|
網路資源的目前連線。 |
|
所有網路資源。 這些可能或可能未連線。 |
|
與使用者目前和預設網路內容相關聯的網路資源。 這的意義是提供者特定的。 |
dwType
表示資源類型。 這可以是下列其中一個值。
值 | 意義 |
---|---|
|
資源是共用磁片區。 |
|
資源是共用印表機。 |
|
資源符合多個類型,例如,列印和磁片資源的容器,或是不是列印或磁片的資源。 |
dwDisplayType
由提供者設定,以指出使用者介面應該用來表示此資源的顯示類型。 定義下列類型。
dwUsage
位元遮罩,指出如何列舉資源的相關資訊。 只有在 dwScope 設定為 RESOURCE_GLOBALNET 時,才會定義它。 dwUsage欄位可以包含下列一或多個旗標。
值 | 意義 |
---|---|
|
您可以呼叫 NPAddConnection來連線到資源。 如果 dwType 是RESOURCETYPE_DISK,則在連線到資源之後,您可以使用檔案系統 API,例如 FindFirstFile和 FindNextFile,列舉資源包含的任何檔案和目錄。 |
|
資源是其他資源的容器,可透過 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 |