Share via

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。

関数が失敗した場合、戻り値には、次のいずれかのエラー コードまたは システム エラー コードのいずれかを指定できます。

リターン コード 説明
ERROR_INVALID_PARAMETER
 パラメーターが正しくありません。
NERR_SetupNotJoined
 コンピューターは現在ドメインに参加していません。
NERR_SetupDomainController
 このコンピューターはドメイン コントローラーであり、ドメインから参加解除することはできません。

注釈

ドメインまたはワークグループへのコンピューターの参加解除 (および参加) は、ターゲット コンピューターの Administrators ローカル グループのメンバーのみが実行できます。 NetUnjoinDomain 関数をリモートで呼び出す場合は、このような状況では資格情報を委任できないため、資格情報を指定する必要があります。

異なるプロセス、または同じプロセスの異なるスレッドは、 NetUnjoinDomain 関数を同時に呼び出さないでください。 この状況により、コンピューターの状態が不整合になる可能性があります。

操作を完了するには、 NetRenameMachineInDomain 関数を呼び出した後、システムの再起動が必要です。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー lmjoin.h (include Lm.h)
Library Netapi32.lib
[DLL] Netapi32.dll

こちらもご覧ください

NetJoinDomain

NetRenameMachineInDomain

ネットワーク管理機能

ネットワーク管理の概要