NetRenameMachineInDomain 関数 (lmjoin.h)
NetRenameMachineInDomain 関数は、ドメイン内のコンピューターの名前を変更します。
構文
NET_API_STATUS NET_API_FUNCTION NetRenameMachineInDomain(
[in] LPCWSTR lpServer,
[in] LPCWSTR lpNewMachineName,
[in] LPCWSTR lpAccount,
[in] LPCWSTR lpPassword,
[in] DWORD fRenameOptions
);
パラメーター
[in] lpServer
関数を呼び出すコンピューターの DNS または NetBIOS 名を指定する定数文字列へのポインター。 このパラメーターが NULL の場合は、ローカル コンピューターが使用されます。
[in] lpNewMachineName
コンピューターの新しい名前を指定する定数文字列へのポインター。 指定すると、ローカル コンピューター名も変更されます。 このパラメーターが NULL の場合、関数は SetComputerNameEx 関数を既に呼び出していることを前提としています。
[in] lpAccount
ドメイン コントローラーへの接続時に使用するアカウント名を指定する定数文字列へのポインター。 このパラメーターが NULL の場合、呼び出し元のコンテキストが使用されます。
[in] lpPassword
lpAccount パラメーターでアカウント名を指定する場合、このパラメーターはドメイン コントローラーへの接続時に使用するパスワードを指す必要があります。 それ以外の場合、このパラメーターは NULL である必要があります。
[in] fRenameOptions
名前変更オプション。 このパラメーターがNETSETUP_ACCT_CREATE場合、関数はドメイン内のアカウントの名前を変更します。
戻り値
関数が成功した場合、戻り値はNERR_Success。
関数が失敗した場合、戻り値には、次のいずれかのエラー コードまたは システム エラー コードのいずれかを指定できます。
| リターン コード | 説明 |
|---|---|
|
アクセスが拒否されました。 このエラーは、 lpAccount パラメーターで渡されたアカウント名に操作に対する十分なアクセス権がなかった場合に返されます。 |
|
パラメーターが正しくありません。 |
|
コンピューターは現在ドメインに参加していません。 |
|
このコンピューターはドメイン コントローラーであり、ドメインから参加解除することはできません。 |
解説
ドメイン コンピューターの名前変更は、ターゲット コンピューターの Administrators ローカル グループのメンバーであり、ドメインの Administrators グループのメンバーであるか、ドメインに対するアカウント オペレーター特権を持つユーザーのみが実行できます。 NetRenameMachineInDomain 関数をリモートで呼び出す場合は、このような状況では資格情報を委任できないため、資格情報を指定する必要があります。
異なるプロセス、または同じプロセスの異なるスレッドは、 NetRenameMachineInDomain 関数を同時に呼び出さないでください。 この状況により、コンピューターの状態が不整合になる可能性があります。
NERR_SetupNotJoinedとNERR_SetupDomainController戻り値は、Lmerr.h ヘッダー ファイルで定義されます。 このヘッダー ファイルは Lm.h ヘッダー ファイルによって自動的に含まれ、直接含めるべきではありません。
操作を完了するには、 NetRenameMachineInDomain 関数を呼び出した後、システムの再起動が必要です。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | lmjoin.h (include Lm.h) |
| Library | Netapi32.lib |
| [DLL] | Netapi32.dll |