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 を呼び出します。
| リターン コード | 説明 |
|---|---|
|
指定されたバッファー サイズが十分に大きくなかったか、 正しく NULL に設定されていませんでした。 |
|
パラメーター値が無効でした。 |
|
フラグに指定された値が無効でした。 |
注釈
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 |