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