GetGeoInfoEx 関数 (winnls.h)

2 文字の国際標準化機構 (ISO) 3166-1 コードまたは数値の国連 (UN) シリーズ M、数値 49 (M.49) コードを使用して指定した地理的な場所に関する情報を取得します。

構文

int GetGeoInfoEx(
  [in]            PWSTR   location,
  [in]            GEOTYPE geoType,
  [out, optional] PWSTR   geoData,
  [in]            int     geoDataCount
);

パラメーター

[in] location

情報を取得する地理的な場所の 2 文字の ISO 3166-1 または数値の UN M.49 コード。 オペレーティング システムで使用できるコードを取得するには、 EnumSystemGeoNames を呼び出します。

[in] geoType

取得する情報の種類。 使用可能な値は、 SYSGEOTYPE 列挙体によって定義されます。 SYSGEOTYPE 列挙の次の値は、GetGeoInfoEx では使用しないでください。

• GEO_ID

  この値は、下位互換性のために提供されます。 新しいアプリケーションではこの値を使用しませんが、代わりに GEO_NAME を使用してください。

• GEO_LCID

  この値は、 GetGeoInfoEx 関数ではサポートされていません。

• GEO_NATION

  この値は、 GetGeoInfoEx 関数ではサポートされていません。

• GEO_RFC1766

  この値は、 GetGeoInfoEx 関数ではサポートされていません。

[out, optional] geoData

GetGeoInfoEx が要求された情報を書き込むバッファーへのポインター。

[in] geoDataCount

GeoData パラメーターが指すバッファーのサイズ (文字単位)。 このパラメーターを 0 に設定して、要求された情報をバッファーに書き込まずに、要求された情報を格納するために必要なバッファーのサイズのみを関数が返すように指定します。

戻り値

関数が出力バッファーを書き込んだ地理的位置情報のバイト数。 geoDataCount が 0 の場合、関数は情報をバッファーに書き込まずに情報を保持するために必要なバッファーのサイズを返します。

0 は、関数が成功しなかったことを示します。 拡張エラー情報を取得するには、次のいずれかのエラー コードを返す GetLastError を呼び出します。

リターン コード	説明
ERROR_INSUFFICIENT_BUFFER	指定されたバッファー サイズが十分に大きくなかったか、 正しく NULL に設定されていませんでした。
ERROR_INVALID_PARAMETER	パラメーター値が無効でした。
ERROR_INVALID_FLAGS	フラグに指定された値が無効でした。

注釈

2 文字の ISO 3166-1 コードの詳細については、「 Country Codes - ISO 3166」を参照してください。 数値の UN M.49 コードの詳細については、「 統計使用のための標準の国コードまたは市外域コード (M49)」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 10、バージョン 1709 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	winnls.h
Library	Kernel32.lib
[DLL]	Kernel32.dll

関連項目

EnumSystemGeoNames

GetGeoInfo

各国語サポート

各国語サポート関数

SYSGEOTYPE