NetUseDel 函式 (lmuse.h)
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 標頭檔中定義的下列其中一個值。
值 | 意義 |
---|---|
|
如果連線上存在開啟的檔案,則中斷連線。 |
|
如果連線上有開啟的檔案,請勿讓中斷連線失敗。 |
|
關閉任何開啟的檔案並刪除連線。 |
傳回值
如果函式成功,傳回值會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 |