SetComputerNameExW

ローカルコンピュータの新しい NetBIOS または DNS 名を設定する。(Unicode)

SetComputerNameExW NameType, lpBuffer

NameType : [int] 
lpBuffer : [wstr] 新しい名前。名前に制御文字、先頭または末尾の空白、および次の文字を含めることはできない: " / \ [ ] : | < > + = ; , ?

(プラグイン / モジュール : kernel32.dll)

解説

ローカルコンピュータの新しい NetBIOS または DNS 名を設定する。(Unicode)

[戻り値]
関数が成功した場合、戻り値は非ゼロである。失敗した場合はゼロである。拡張エラー情報を取得するには GetLastError を呼び出す。

[備考]
SetComputerNameEx はローカルコンピュータのコンピュータ名 (完全 DNS 名の先頭ラベル) またはプライマリ DNS
サフィックスを設定できる。1 回の呼び出しで完全修飾 DNS
名を設定することはできない。ローカルコンピュータがクラスタノードの場合、SetComputerNameEx
はクラスタ仮想サーバーではなくローカルコンピュータの NetBIOS/DNS 名を設定する。SetComputerNameEx
を呼び出すプロセスは、ローカルコンピュータで管理者権限を持つ必要がある。この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT
を 0x0500 以降として定義する。詳細は「Windows ヘッダの使用」を参照。
> [!NOTE] > sysinfoapi.h ヘッダは SetComputerNameEx を、UNICODE
プリプロセッサ定数の定義に応じて ANSI 版または Unicode
版を自動選択するエイリアスとして定義する。エンコーディング中立なエイリアスと中立でないコードを混在させると、コンパイルエラーや実行時エラーを引き起こすことがある。詳細は
[関数プロトタイプの規約](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報