NetUnjoinDomain 函式 (lmjoin.h)
NetUnjoinDomain 函式會從工作組或網域取消加入計算機。
語法
NET_API_STATUS NET_API_FUNCTION NetUnjoinDomain(
[in] LPCWSTR lpServer,
[in] LPCWSTR lpAccount,
[in] LPCWSTR lpPassword,
[in] DWORD fUnjoinOptions
);
參數
[in] lpServer
常數位符串的指標,指定函式執行所在計算機的 DNS 或 NetBIOS 名稱。 如果此參數為 NULL,則會使用本機電腦。
[in] lpAccount
常數位符串的指標,指定連接到域控制器時要使用的帳戶名稱。 字串必須指定網域 NetBIOS 名稱和使用者帳戶 (,例如 REDMOND\user) ,或是使用者主體名稱 (UPN) 的用戶主體名稱, (例如 “someone@example.com”) 。 如果此參數為 NULL,則會使用呼叫端的內容。
[in] lpPassword
如果 lpAccount 參數指定帳戶名稱,此參數必須指向連接到域控制器時要使用的密碼。 否則,此參數必須是 NULL。
[in] fUnjoinOptions
指定取消加入的選項。 如果此參數NETSETUP_ACCT_DELETE,當發生取消加入時,就會停用帳戶。 請注意,此選項不會刪除帳戶。 目前未定義其他未加入的選項。
傳回值
如果函式成功,傳回值會NERR_Success。
如果函式失敗,傳回值可以是下列其中一個錯誤碼或其中一個 系統錯誤碼。
傳回碼 | Description |
---|---|
|
參數不正確。 |
|
計算機目前未加入網域。 |
|
這部計算機是域控制器,無法從網域取消加入。 |
備註
將電腦取消加入 (,並將) 加入網域或工作組,只能由目標計算機上的 Administrators 本地組成員執行。 如果您從遠端呼叫 NetUnjoinDomain 函式,您必須提供認證,因為在這些情況下無法委派認證。
不同進程或相同進程的不同線程不應該同時呼叫 NetUnjoinDomain 函式。 這種情況可能會讓計算機處於不一致的狀態。
呼叫 NetRenameMachineInDomain 函式以完成作業之後,需要系統重新啟動。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | lmjoin.h (包含 Lm.h) |
程式庫 | Netapi32.lib |
Dll | Netapi32.dll |