GetGeoInfoA 関数 (winnls.h)

[アーティクル]
11/20/2024

[GetGeoInfo は、[要件] セクションで指定したオペレーティングシステムで使用できます。以降のバージョンでは、変更または使用できない場合があります。代わりに、GetGeoInfoEx使用します。

]

指定した地理的な場所に関する情報を取得します。

構文

int GetGeoInfoA(
  [in]            GEOID   Location,
  [in]            GEOTYPE GeoType,
  [out, optional] LPSTR   lpGeoData,
  [in]            int     cchData,
  [in]            LANGID  LangId
);

パラメーター

[in] Location

情報を取得する地理的な場所の識別子。詳細については、「地理的位置のテーブル」を参照してください。 EnumSystemGeoID呼び出すことで、使用可能な値を取得できます。

[in] GeoType

取得する情報の種類。使用可能な値は、SYSGEOTYPE 列挙型によって定義されます。 GeoType の値がGEO_LCID場合、関数はロケール識別子を取得します。 GeoType の値がGEO_RFC1766場合、関数は RFC 4646 (Windows Vista) に準拠している文字列名を取得します。詳細については、「解説」セクションを参照してください。

Windows XP: GeoType が GEO_LCID に設定されている場合、取得される文字列は 8 桁の 16 進数の値になります。

Windows Me: GeoType が GEO_LCID に設定されている場合、取得される文字列は 10 進値になります。

[out, optional] lpGeoData

この関数が情報を取得するバッファーへのポインター。

[in] cchData

lpGeoDataによって示されるバッファーサイズ。サイズは、ANSI バージョンの関数のバイト数、または Unicode バージョンの単語数です。関数がバッファーの必要なサイズを返す場合、アプリケーションはこのパラメーターを 0 に設定できます。

[in] LangId

Locationの値と共に使用される言語の識別子。アプリケーションでは、GeoTypeに対して GEO_RFC1766 または GEO_LCID を指定して、このパラメーターを 0 に設定できます。この設定により、GetUserDefaultLangID呼び出して、関数が言語識別子を取得します。

メモ GeoType に GEO_RFC1766 または GEO_LCID 以外の値がある場合は、このパラメーターを 0 に設定する必要があります。

戻り値

出力バッファーで取得された地理的位置情報のバイト数 (ANSI) または単語 (Unicode) を返します。 cchData が 0 に設定されている場合、この関数はバッファーに必要なサイズを返します。

成功しなかった場合、関数は 0 を返します。拡張エラー情報を取得するために、アプリケーションは GetLastError呼び出すことができます。これは、次のいずれかのエラーコードを返すことができます。

ERROR_INSUFFICIENT_BUFFER。指定されたバッファーサイズが十分な大きさではなかったか、NULL正しく設定されていません。
ERROR_INVALID_PARAMETER。パラメーター値のいずれかが無効でした。

備考

アプリケーションで GeoTypeのGEO_RFC1766を指定する場合は、指定した地理的な場所の識別子に適した言語識別子 LangId を指定する必要があります。適切な言語は、ロケールに依存しない言語か、指定された識別子に対応するロケールを持つ言語です。 RFC 4646 (Windows Vista) に準拠した結果の文字列は、ロケール名を構成します。

たとえば、Location が米国の0xF4として指定されている場合、GeoType は GEO_RFC1766 として指定 され、LangId はロケールに依存しない英語の場合は 0x09 として指定され、英語 (米国) の場合は 0x409 として指定され、関数は正常に戻ると "en-US" を取得します。実際、この関数は言語のロケール固有の部分を無視します。したがって、アプリケーション LangId を英語 (英国) の0x809として指定した場合、この関数は lpGeoDataをするために "en-US" も書き込みます。

別の例を考えてみましょう。 Location が米国の0xF4として指定されている場合、GeoType は GEO_RFC1766 として指定され、LangId 中国語の場合は0x04として指定され、関数は正常に戻ると "zh-US" を取得します。これは、サポートされているロケールの名前ではありません。

アプリケーションで GeoTypeのGEO_LCIDが指定されている場合、関数は言語識別子をロケール識別子 (LCID) として扱います。指定された地理的識別子に何らかの方法で関連付けられている場合は、ロケール識別子を返そうとします。

手記

winnls.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetGeoInfo を定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows XP [デスクトップアプリ \|UWP アプリ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップアプリ \|UWP アプリ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	winnls.h (Windows.h を含む)
ライブラリ	Kernel32.lib
DLL	Kernel32.dll

次の方法で共有

GetGeoInfoA 関数 (winnls.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース