共用方式為

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
ERROR_INVALID_PARAMETER
 參數不正確。
NERR_SetupNotJoined
 計算機目前未加入網域。
NERR_SetupDomainController
 這部計算機是域控制器，無法從網域取消加入。

備註

將電腦取消加入 (，並將) 加入網域或工作組，只能由目標計算機上的 Administrators 本地組成員執行。 如果您從遠端呼叫 NetUnjoinDomain 函式，您必須提供認證，因為在這些情況下無法委派認證。

不同進程或相同進程的不同線程不應該同時呼叫 NetUnjoinDomain 函式。 這種情況可能會讓計算機處於不一致的狀態。

呼叫 NetRenameMachineInDomain 函式以完成作業之後，需要系統重新啟動。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 lmjoin.h (包含 Lm.h)
程式庫 Netapi32.lib
Dll Netapi32.dll

另請參閱

NetJoinDomain

NetRenameMachineInDomain

網路管理功能

網路管理概觀