<Return[S]><Top>

SetComputerNameEx

Declare Function Api_SetComputerNameEx& Lib "Kernel32" Alias "SetComputerNameExA"(ByVal NameType&, ByVal lpBuffer$)

Declare Function SetComputerNameEx Lib "Kernel32" Alias "SetComputerNameExA"(ByVal NameType As Long, ByVal lpBuffer As String) As Long

ローカルコンピュータの NetBIOS 名または DNS 名を設定する。この関数で変更した名前は、ユーザーがコンピュータを再起動するまで有効にならない。
SetComputerName 関数で設定できる NetBIOS 名に加えて、この関数はローカルコンピュータの DNS ホスト名または DNS ドメイン名を設定できる。完全修飾 DNS 名は設定できない。
ローカルコンピュータがクラスタ内のノードの 1 つである場合も、クラスタではなく、ローカルコンピュータの NetBIOS 名または DNS 名を設定する。

パラメータ
NameType
    設定する名前の種類を指定する。次の 列挙型のいずれかの値を使う。

    値                                                       

説明                                                                                                                      

    ComputerNamePhysicalNetBIOS

　

NetBIOS 名と DNS ホスト名を lpBuffer で指定した名前に設定する。名前は、終端の NULL 文字を除いた長さが MAX_COMPUTERNAME_LENGTH 文字を超えることはできない。

    ComputerNamePhysicalDnsHostname

　

　

NetBIOS 名と DNS ホスト名を lpBuffer で指定した名前に設定する。指定した名前の長さが MAX_COMPUTERNAME_LENGTH 文字を超えると、終端の NULL 文字を除く長さが MAX_COMPUTERNAME_LENGTH 文字になるように NetBIOS 名が短くなる。

    ComputerNamePhysicalDnsDomain

コンピュータに割り当てられている DNS ドメインの名前を設定する。

lpBuffer
    新しい名前を表す NULL で終わる文字列へのポインタを指定する。この名前の先頭と終端に空白を含むことはできない。また、制御文字

    と次の文字は使うことができない。
    "/\ [ ] : | < > + = ; , ?

戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。拡張エラー情報を取得するには、 関数を使う。

解説
    SetComputerNameEx 関数を呼び出すプロセスには、ローカルコンピュータの管理者権限が必要である。