NetRemoveAlternateComputerName 関数 (lmjoin.h)

  • [アーティクル]

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

構文

NET_API_STATUS NET_API_FUNCTION NetRemoveAlternateComputerName(
  [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
 リモート プロシージャ コール プロトコル シーケンスはサポートされていません。

解説

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

NetRemoveAlternateComputerName 関数は、ターゲット コンピューター用に構成されたセカンダリ コンピューター名を削除するために使用されます。

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

要件

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

関連項目

NetAddAlternateComputerName

NetEnumerateComputerNames

NetJoinDomain

NetRenameMachineInDomain

NetSetPrimaryComputerName

NetUnjoinDomain

SetComputerNameEx