NetSetPrimaryComputerName 関数 (lmjoin.h)

[アーティクル]
03/05/2024

NetSetPrimaryComputerName 関数は、指定したコンピューターのプライマリコンピューター名を設定します。

構文

NET_API_STATUS NET_API_FUNCTION NetSetPrimaryComputerName(
  [in, optional] LPCWSTR Server,
  [in]           LPCWSTR PrimaryName,
  [in, optional] LPCWSTR DomainAccount,
  [in, optional] LPCWSTR DomainAccountPassword,
  [in]           ULONG   Reserved
);

パラメーター

[in, optional] Server

この関数を実行するコンピューターの名前を指定する定数文字列へのポインター。このパラメーターが NULL の場合は、ローカルコンピューターが使用されます。

[in] PrimaryName

設定するプライマリ名を指定する定数文字列へのポインター。この名前は、完全修飾 DNS 名の形式である必要があります。

[in, optional] DomainAccount

Active Directory の Server パラメーターで指定されたコンピューターのコンピューターアカウントオブジェクトへのアクセスに使用するドメインアカウントを指定する定数文字列へのポインター。このパラメーターが NULL の場合は、このルーチンを実行しているユーザーの資格情報が使用されます。

この関数を実行するサーバーがドメインに参加していない場合、このパラメーターは使用されません。

[in, optional] DomainAccountPassword

DomainAccount パラメーターで渡されたドメインアカウントに一致するパスワードを指定する定数文字列へのポインター。このパラメーターが NULL の場合は、このルーチンを実行しているユーザーの資格情報が使用されます。

DomainAccount パラメーターが NULL の場合、このパラメーターは無視されます。この関数を実行するサーバーがドメインに参加していない場合、このパラメーターは使用されません。

[in] Reserved

将来利用するために予約されています。このパラメーターは NULL にする必要があります。

戻り値

関数が成功した場合、戻り値はNERR_Success。

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

リターンコード	説明
ERROR_ACCESS_DENIED	アクセスが拒否されました。このエラーは、呼び出し元がターゲットコンピューター上の Administrators ローカルグループのメンバーでない場合に返されます。
ERROR_INVALID_NAME	name パラメーターが正しくありません。 PrimaryName パラメーターに有効な名前が含まれていない場合、このエラーが返されます。
ERROR_INVALID_PARAMETER	パラメーターが正しくありません。 DomainAccount パラメーターに有効なドメインが含まれていない場合、このエラーが返されます。 DomainAccount パラメーターが NULL ではなく、DomainAccountPassword パラメーターが NULL ではなく Unicode 文字列を含まない場合も、このエラーが返されます。
ERROR_NOT_ENOUGH_MEMORY	このコマンドを処理するのに十分なメモリがありません。
ERROR_NOT_SUPPORTED	要求はサポートされていません。この関数を実行する Server パラメーターで指定されたターゲットコンピューターが Windows 2000 以前で実行されている場合、このエラーが返されます。
NERR_WkstaNotStarted	ワークステーションサービスが開始されていません。
RPC_S_CALL_IN_PROGRESS	このスレッドでリモートプロシージャコールが既に進行中です。
RPC_S_PROTSEQ_NOT_SUPPORTED	リモートプロシージャコールプロトコルシーケンスはサポートされていません。

注釈

NetSetPrimaryComputerName 関数は、Windows XP 以降でサポートされています。

NetSetPrimaryComputerName 関数は、コンピューターの名前変更操作の一部として使用されます。指定した名前は、ターゲットコンピューター用に構成され、プライマリ名として構成された代替名の一覧から削除されます。コンピューターアカウント名は、プライマリ名と一致するように変更されます。前のプライマリコンピューター名は、コンピューター用に構成された代替コンピューター名の一覧に移動されます。

NetSetPrimaryComputerName 関数では、呼び出し元がターゲットコンピューターの Administrators ローカルグループのメンバーである必要があります。

要件

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