NetUseDel 函式 (lmuse.h)

發行項
08/24/2023

NetUseDel函式會結束與共用資源的連線。

您也可以使用 WNetCancelConnection2 函式來終止網路連線。

語法

NET_API_STATUS NET_API_FUNCTION NetUseDel(
  [in] LMSTR UncServerName,
  [in] LMSTR UseName,
  [in] DWORD ForceLevelFlags
);

參數

[in] UncServerName

要執行此函式之電腦的 UNC 名稱。如果此參數為 Null，則會使用本機電腦。

如果指定的 UncServerName 參數是遠端電腦，則遠端電腦必須使用舊版遠端存取通訊協定機制支援遠端 RPC 呼叫。

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

[in] UseName

字串的指標，指定要刪除之連接的路徑。

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

[in] ForceLevelFlags

要用於刪除連線的強制層級。

此參數可以是 lmuseflg.h 標頭檔中定義的下列其中一個值。

值	意義
USE_NOFORCE	如果連線上存在開啟的檔案，則中斷連線。
USE_FORCE	如果連線上有開啟的檔案，請勿讓中斷連線失敗。
USE_LOTS_OF_FORCE	關閉任何開啟的檔案並刪除連線。

傳回值

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

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

備註

NetUseDel函式僅適用于伺服器訊息區 (LAN Manager 工作站) 用戶端。 NetUseDel函式不支援分散式檔案系統 (DFS) 共用或其他網路檔案系統。若要使用不同的網路提供者終止與共享的連線， (WebDAV 或 DFS 共用，例如) ，請使用 WNetCancelConnection2 函式。

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

需求


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