NetUseGetInfo 函式 (lmuse.h)

發行項
08/24/2023

NetUseGetInfo函式會擷取與共用資源連線的相關資訊。

您也可以使用 WNetGetConnection 函式來擷取與本機裝置相關聯的網路資源名稱。

語法

NET_API_STATUS NET_API_FUNCTION NetUseGetInfo(
  [in]  LMSTR  UncServerName,
  [in]  LMSTR  UseName,
  [in]  DWORD  LevelFlags,
  [out] LPBYTE *bufptr
);

參數

[in] UncServerName

要在其中執行此函式之電腦的 UNC 名稱。如果此參數為 Null，則會使用本機電腦。如果指定的 UncServerName 參數是遠端電腦，則遠端電腦必須使用舊版遠端存取通訊協定機制支援遠端 RPC 呼叫。

如果已定義 _WIN32_WINNT 或 FORCE_UNICODE ，則此字串為 Unicode。

[in] UseName

字串的指標，指定要傳回信息的連接名稱。

如果已定義 _WIN32_WINNT 或 FORCE_UNICODE ，則此字串為 Unicode。

[in] LevelFlags

要求之資料的資訊層級。此參數可以是下列其中一個值。

值	意義
0	指定本機裝置名稱和遠端資源的共用名稱稱。 BufPtr參數是USE_INFO_0結構的指標。
1	指定本機裝置與共用資源之間的連線相關資訊，包括線上狀態和類型。 BufPtr參數是USE_INFO_1結構的指標。
2	指定本機裝置與共用資源之間的連線相關資訊。資訊包括線上狀態、連線類型、使用者名稱和功能變數名稱。 BufPtr參數是USE_INFO_2結構的指標。

[out] bufptr

接收資料的緩衝區指標。此資料的格式取決於 Level 參數的值。此緩衝區是由系統所配置，而且必須使用 NetApiBufferFree 函式釋放。如需詳細資訊，請參閱網路管理功能緩衝區和網路管理功能緩衝區長度。

傳回值

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

如果函式失敗，則傳回值是系統錯誤碼。如需錯誤碼的清單，請參閱系統錯誤碼。

備註

呼叫 NetUseGetInfo 函式不需要特殊群組成員資格。此函式無法在遠端伺服器上執行，但發生下層相容性的情況除外。

若要列出本機電腦與遠端伺服器上資源之間的所有目前連線，您可以呼叫 NetUseEnum 函式。

此函式僅適用于伺服器訊息區 (LAN Manager 工作站) 用戶端。 NetUseGetInfo函式不支援分散式檔案系統 (DFS) 共用。若要使用不同的網路提供者來擷取共用的資訊， (WebDAV 或 DFS 共用，例如) ，請使用 WNetGetConnection 函式。

需求


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	lmuse.h (包括 Lm.h)
程式庫	Netapi32.lib
Dll	Netapi32.dll