SetComputerNameA 関数 (sysinfoapi.h)
ローカル コンピューターの新しい NetBIOS 名を設定します。 名前はレジストリに格納され、ユーザーが次回コンピューターを再起動すると、名前の変更が有効になります。
ローカル コンピューターがクラスター内のノードである場合、SetComputerName
DNS ホスト名または DNS ドメイン名を設定するには、SetComputerNameEx 関数を呼び出します。
構文
BOOL SetComputerNameA(
[in] LPCSTR lpComputerName
);
パラメーター
[in] lpComputerName
次回コンピューターが起動されるときに有効になるコンピューター名。 名前はMAX_COMPUTERNAME_LENGTH文字以下にする必要があります。
標準文字セットには、文字、数字、および次の記号が含まれます。 @ # $ % ^ & ' ) ( . - _ { } ~ . このパラメーターに標準文字セットの外部にある 1 つ以上の文字が含まれている場合は、SetComputerName
戻り値
関数が成功した場合、戻り値は 0 以外の値になります。
関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError
備考
この関数を使用するアプリケーションには管理者権限が必要です。
手記
sysinfoapi.h ヘッダーは、SetComputerName をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | sysinfoapi.h (Windows.h を含む) |
| ライブラリ | Kernel32.lib |
| DLL | Kernel32.dll |