NetSetPrimaryComputerName 関数 (lmjoin.h)
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。
関数が失敗した場合、戻り値には、次のいずれかのエラー コードまたは システム エラー コードのいずれかを指定できます。
リターン コード | 説明 |
---|---|
|
アクセスが拒否されました。 このエラーは、呼び出し元がターゲット コンピューター上の Administrators ローカル グループのメンバーでない場合に返されます。 |
|
name パラメーターが正しくありません。 PrimaryName パラメーターに有効な名前が含まれていない場合、このエラーが返されます。 |
|
パラメーターが正しくありません。 DomainAccount パラメーターに有効なドメインが含まれていない場合、このエラーが返されます。 DomainAccount パラメーターが NULL ではなく、DomainAccountPassword パラメーターが NULL ではなく Unicode 文字列を含まない場合も、このエラーが返されます。 |
|
このコマンドを処理するのに十分なメモリがありません。 |
|
要求はサポートされていません。 この関数を実行する Server パラメーターで指定されたターゲット コンピューターが Windows 2000 以前で実行されている場合、このエラーが返されます。 |
|
ワークステーション サービスが開始されていません。 |
|
このスレッドでリモート プロシージャ コールが既に進行中です。 |
|
リモート プロシージャ コール プロトコル シーケンスはサポートされていません。 |
注釈
NetSetPrimaryComputerName 関数は、Windows XP 以降でサポートされています。
NetSetPrimaryComputerName 関数は、コンピューターの名前変更操作の一部として使用されます。 指定した名前は、ターゲット コンピューター用に構成され、プライマリ名として構成された代替名の一覧から削除されます。 コンピューター アカウント名は、プライマリ名と一致するように変更されます。 前のプライマリ コンピューター名は、コンピューター用に構成された代替コンピューター名の一覧に移動されます。
NetSetPrimaryComputerName 関数では、呼び出し元がターゲット コンピューターの Administrators ローカル グループのメンバーである必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | lmjoin.h (include Lm.h) |
Library | Netapi32.lib |
[DLL] | Netapi32.dll |