<Return[G]><Top>

GetComputerName

Declare Function Api_GetComputerName& Lib "kernel32" Alias "GetComputerNameA" (ByVal lpBuffer$, nSize&)

Declare Function GetComputerName Lib "kernel32" Alias "GetComputerNameA" (ByVal lpBuffer As String, nSize As Long) As Long

ローカルコンピュータの NetBIOS 名を取得する。この名前はシステムの起動時に確立されるもので、システムはレジストリからこの名前を読み取る。
ローカルコンピュータがクラスタの 1 つのノードである場合、GetComputerName 関数はノード名を取得する。
Windows 2000:GetComputerName 関数は、ローカルコンピュータの NetBIOS 名だけを取得する。DNS ホスト名または完全修飾 DNS 名を取得するには、GetComputerNameEx 関数を使う。

パラメータ
lpBuffer
    1 個のバッファへのポインタを指定する。

    関数から制御が返ると、このバッファに、コンピュータ名を表す、NULL で終わる文字列が格納される。

    バッファのサイズとして、MAX_COMPUTERNAME_LENGTH + 1 文字を保持できる大きさを指定する。
lpnSize
    バッファのサイズを TCHAR 単位で保持している 1 個の変数へのポインタを指定する。

    関数から制御が返ると、この変数に、格納先のバッファへコピーされた文字の数が TCHAR 単位で格納される

    (終端の NULL を含まない)。
    バッファが小さすぎてコンピュータ名を格納できない場合、この関数は失敗し、GetLastError 関数は ERROR_BUFFER_OVERFLOW

    を返す。
    Windows 95/98:入力サイズが MAX_COMPUTERNAME_LENGTH + 1 未満である場合、GetComputerName 関数は失敗する。

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

解説
    GetComputerName 関数は、システムの起動時に確立された NetBIOS 名を取得する。SetComputerName または

    SetComputerNameEx 関数を使って名前を変更した場合でも、ユーザーがコンピュータを再起動するまでは、変更後の名前は有効になら

    ない。