WNetGetResourceParentA 函式 (winnetwk.h)

發行項
03/13/2024

WNetGetResourceParent 函式會傳回網路瀏覽階層中網路資源的父系。流覽會從指定網路資源的位置開始。

呼叫 WNetGetResourceInformation 和 WNetGetResourceParent 函式，以向上移動網路階層。呼叫 WNetOpenEnum 函式以向下移動階層。

語法

DWORD WNetGetResourceParentA(
  [in]      LPNETRESOURCEA lpNetResource,
  [out]     LPVOID         lpBuffer,
  [in, out] LPDWORD        lpcbBuffer
);

參數

[in] lpNetResource

NETRESOURCE 結構的指標，指定需要父名稱的網路資源。

指定輸入 NETRESOURCE 結構的成員，如下所示。呼叫端通常知道在先前呼叫 WNetGetResourceInformation 或 WNetGetResourceParent 之後，要為 lpProvider 和 dwType 成員提供的值。

成員	意義
dwType	如果已知，應該填入此成員;否則，它應該設定為 NULL。
lpRemoteName	此成員應指定其父系為必要之網路資源的遠端名稱。
lpProvider	此成員應指定擁有資源的網路提供者。需要此成員;否則，函式可能會產生不正確的結果。

系統會忽略 NETRESOURCE 結構的所有其他成員。

[out] lpBuffer

緩衝區的指標，以接收代表父資源的單一 NETRESOURCE 結構。函式會傳回結構的 lpRemoteName、 lpProvider、 dwType、 dwDisplayType 和 dwUsage 成員;所有其他成員都會設定為 NULL。

lpRemoteName 成員會指向父資源的遠端名稱。此名稱會使用與 WNetEnumResource 函式從列舉傳回的語法相同。呼叫端可以執行字串比較，以判斷 WNetGetResourceParent 資源是否與 WNetEnumResource 所傳回的資源相同。如果輸入資源在任何網路上沒有父系， lpRemoteName 成員會傳回為 NULL。

dwUsage 成員中有RESOURCEUSAGE_CONNECTABLE位，表示您可以連線到父資源，但只有在網路上可以使用時。

[in, out] lpcbBuffer

專案上位置的指標會以位元組為單位指定 lpBuffer 緩衝區的大小。如果緩衝區太小而無法保存結果，這個位置會收到所需的緩衝區大小，而函式會傳回ERROR_MORE_DATA。

傳回值

如果函式成功，傳回值會NO_ERROR。

如果函式失敗，傳回值是系統錯誤碼，例如下列其中一個值。

傳回碼	Description
ERROR_ACCESS_DENIED	呼叫端無法存取網路資源。
ERROR_BAD_NET_NAME	輸入 lpRemoteName 成員不是任何網路的現有網路資源。
ERROR_BAD_PROVIDER	輸入 lpProvider 成員不符合任何已安裝的網路提供者。
ERROR_MORE_DATA	lpBuffer 參數所指向的緩衝區太小。
ERROR_NOT_AUTHENTICATED	呼叫端沒有取得父系名稱的必要許可權。

備註

WNetGetResourceParent 函式通常會與 WNetGetResourceInformation 函式搭配使用，以剖析和解譯使用者輸入的網路路徑。

不同於 WNetGetResourceInformation 函式，如果資源在其語法中包含父系， 則 WNetGetResourceParent 函式會傳回父代，不論資源是否確實存在。 WNetGetResourceParent 通常只能由以階層方式向使用者顯示網路資源的應用程式使用。 Windows 檔案總管和 [ 檔案開啟] 對話框是這種類型的應用程式已知範例。請注意，不應該假設將傳回的資源類型。

您可以呼叫 WNetEnumResource、WNetGetResourceInformation 或 WNetGetResourceParent 函式，以從 NETRESOURCE 結構傳回資訊。您也可以使用 NETRESOURCE 結構的成員來建構網路資源資訊。

不當使用 WNetGetResourceParent 的範例是判斷指定伺服器所屬的功能變數名稱。函式可能會傳回某些網路的正確功能變數名稱，其中網域會直接出現在瀏覽階層中的伺服器上方。函式會傳回其他網路不正確的結果。

注意

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

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winnetwk.h
程式庫	Mpr.lib
Dll	Mpr.dll