NetAddAlternateComputerName 関数 (lmjoin.h)

  • [アーティクル]

NetAddAlternateComputerName 関数は、指定されたコンピューターの代替名を追加します。

構文

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

パラメーター

[in, optional] Server

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

[in] AlternateName

追加する代替名を指定する定数文字列へのポインター。 この名前は、完全修飾 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 パラメーターが正しくありません。 AlternateName パラメーターに有効な名前が含まれていない場合、このエラーが返されます。
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
 リモート プロシージャ コール プロトコル シーケンスはサポートされていません。

解説

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

NetAddAlternateComputerName 関数は、コンピューターのセカンダリ ネットワーク名を設定するために使用されます。 プライマリ名は認証に使用される名前であり、マシン アカウント名にマップされます。

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

要件

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

関連項目

NetEnumerateComputerNames

NetJoinDomain

NetRemoveAlternateComputerName

NetRenameMachineInDomain

NetSetPrimaryComputerName

NetUnjoinDomain

SetComputerNameEx