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 |