SetComputerNameA 関数 (sysinfoapi.h)

ローカル コンピューターの新しい NetBIOS 名を設定します。 名前はレジストリに格納され、ユーザーが次回コンピューターを再起動すると、名前の変更が有効になります。

ローカル コンピューターがクラスター内のノードである場合、 SetComputerName は、クラスター仮想サーバーの名前ではなく、ローカル コンピューターの NetBIOS 名を設定します。

DNS ホスト名または DNS ドメイン名を設定するには、 SetComputerNameEx 関数を呼び出します。

構文

BOOL SetComputerNameA(
  [in] LPCSTR lpComputerName
);

パラメーター

[in] lpComputerName

次回コンピューターが起動されるときに有効になるコンピューター名。 名前は、MAX_COMPUTERNAME_LENGTH文字より長くすることはできません。

標準文字セットには、文字、数字、および次の記号が含まれます: ! @ # $ % ^ & ' ) ( . - _ { } ~ . このパラメーターに標準文字セットの外部にある 1 つ以上の文字が含まれている場合、 SetComputerName は ERROR_INVALID_PARAMETERを返します。

戻り値

関数が成功した場合、戻り値は 0 以外の値になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

この関数を使用するアプリケーションには管理者権限が必要です。

注意

sysinfoapi.h ヘッダーは、SetComputerName をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

関連項目

コンピューター名

GetComputerName

GetComputerNameEx

SetComputerNameEx

システム情報関数