GetComputerNameA 関数 (winbase.h)
ローカル コンピューターの NetBIOS 名を取得します。 この名前は、システムがレジストリから読み取るときに、システムの起動時に確立されます。
GetComputerName は、ローカル コンピューターの NetBIOS 名のみを取得します。 DNS ホスト名、DNS ドメイン名、または完全修飾 DNS 名を取得するには、GetComputerNameEx 関数を呼び出します。 追加情報は、IADsADSystemInfo インターフェイスによって提供されます。
ローカル コンピューターがクラスター内のノードである場合、この関数の動作が影響を受ける可能性があります。 詳細については、「ResUtilGetEnvironmentWithNetName と UseNetworkName
構文
BOOL GetComputerNameA(
[out] LPSTR lpBuffer,
[in, out] LPDWORD nSize
);
パラメーター
[out] lpBuffer
コンピューター名またはクラスター仮想サーバー名を受け取るバッファーへのポインター。 バッファー サイズは、MAX_COMPUTERNAME_LENGTH + 1 文字を含むのに十分な大きさにする必要があります。
[in, out] nSize
入力時に、バッファーのサイズを TCHAR
バッファーが小さすぎると、関数は失敗し、GetLastError
戻り値
関数が成功した場合、戻り値は 0 以外の値になります。
関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError
備考
GetComputerName 関数は、システムの起動時に確立された NetBIOS 名を取得します。
呼び出し元がクライアント セッションで実行されている場合、この関数はサーバー名を返します。 クライアント名を取得するには、WTSQuerySessionInformation 関数を使用します。
例
例については、「システム情報の取得
手記
winbase.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetComputerName を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | winbase.h (Windows.h を含む) |
ライブラリ | Kernel32.lib |
DLL | Kernel32.dll |