GetComputerNameExW

ローカルコンピュータに関連付けられた NetBIOS 名または DNS 名を取得する。これらの名前はシステム起動時にレジストリから読み込まれて確立される。(Unicode)

GetComputerNameExW NameType, lpBuffer, nSize

NameType : [int] 取得する名前の種類。このパラメータは COMPUTER_NAME_FORMAT 列挙型の値である。次の表に追加情報を示す。
lpBuffer : [wstr] コンピュータ名またはクラスタ仮想サーバー名を受け取るバッファへのポインタ。
nSize : [var] 入力時にはバッファのサイズを TCHAR 単位で指定する。出力時には、終端 NULL 文字を含まずに、コピー先バッファにコピーされた TCHAR 数を受け取る。

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

解説

ローカルコンピュータに関連付けられた NetBIOS 名または DNS
名を取得する。これらの名前はシステム起動時にレジストリから読み込まれて確立される。(Unicode)

[戻り値]
関数が成功した場合、戻り値は 0 以外の値である。関数が失敗した場合、戻り値は 0 である。拡張エラー情報を取得するには
GetLastError を呼ぶ。次のような値が返ることがある。
（以下省略）

[備考]
ローカルマシンに対するグループポリシーが設定されていない場合、GetComputerNameEx 関数はシステム起動時に確立された
NetBIOS 名または DNS
名を取得する。グループポリシーが設定されている場合、関数はグループポリシーで設定された主要なドメイン名を返す。SetComputerName
または SetComputerNameEx
関数による名前変更は、ユーザーがコンピュータを再起動するまで反映されない。ローカルコンピュータが DNS
名を使うように構成されていない場合、GetComputerNameEx は DNS
情報を返さない。コンピュータをそのように構成するには、OS のヘルプの手順に従い、コンピュータのプライマリ DNS
サフィックスを変更してから再起動する。ローカルコンピュータがクラスタのノードである場合、この関数の動作は影響を受けることがある。詳細は
ResUtilGetEnvironmentWithNetName と UseNetworkName を参照。コンピュータの FQDN
がそのドメインの FQDN と一致しないような、異なる DNS レイアウトを使う環境を扱う場合は、代わりに
LsaQueryInformationPolicy を使う。この関数を使うアプリケーションをコンパイルするには、_WIN32_WINNT
マクロを 0x0500 以降として定義する。詳細は Using the Windows Headers を参照。

情報