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) ,其格式为 Internet 样式登录名 (例如“”someone@example.com) 。 如果此参数为 NULL,则使用调用方上下文。
[in] lpPassword
如果 lpAccount 参数指定帐户名称,则此参数必须指向连接到域控制器时要使用的密码。 否则,此参数必须为 NULL。
[in] fUnjoinOptions
指定取消加入选项。 如果此参数NETSETUP_ACCT_DELETE,则取消加入时将禁用该帐户。 请注意,此选项不会删除帐户。 目前,没有定义其他未加入的选项。
返回值
如果函数成功,则返回值NERR_Success。
如果函数失败,则返回值可以是以下错误代码之一或 系统错误代码之一。
返回代码 | 说明 |
---|---|
|
参数不正确。 |
|
计算机当前未加入域。 |
|
此计算机是域控制器,不能从域取消加入。 |
注解
取消加入 (,并将) 计算机加入域或工作组只能由目标计算机上的管理员本地组的成员执行。 如果远程调用 NetUnjoinDomain 函数,则必须提供凭据,因为在这种情况下无法委派凭据。
不同进程或同一进程的不同线程不应同时调用 NetUnjoinDomain 函数。 这种情况会使计算机处于不一致状态。
调用 NetRenameMachineInDomain 函数后,需要重新启动系统才能完成操作。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | lmjoin.h (包括 Lm.h) |
Library | Netapi32.lib |
DLL | Netapi32.dll |