GetUserDefaultGeoName 関数 (winnls.h)

ユーザーの既定の地理的位置の 2 文字の国際標準化機構 (ISO) 3166-1 コードまたは数値の国連 (UN) シリーズ M、数値 49 (M.49) コードを取得します。

構文

int GetUserDefaultGeoName(
  [out] LPWSTR geoName,
  [in]  int    geoNameCount
);

パラメーター

[out] geoName

この関数が、ユーザーの既定の地理的な場所に対して null で終わる 2 文字の ISO 3166-1 または数値の UN M.49 コードを書き込むバッファーへのポインター。

[in] geoNameCount

geoName パラメーターが指定するバッファーのサイズ。 この値が 0 の場合、関数は出力バッファーにコピーする文字数のみを返しますが、ユーザーの既定の地理的な場所の名前をバッファーに書き込むことはありません。

戻り値

geoNameCount パラメーターの値が 0 の場合、関数が出力バッファーにコピーする文字数。 それ以外の場合は、 geoName パラメーターが指定するバッファーに関数がコピーした文字数。

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

リターン コード 説明
ERROR_INVALID_PARAMETER
パラメーター値が無効です。
ERROR_BADDB
関数がレジストリから情報を読み取れませんでした。
ERROR_INSUFFICIENT_BUFFER
geoName パラメーターが指定するバッファーが、文字列に対して小さすぎます。

注釈

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

要件

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

関連項目

GetUserGeoID

各国語サポート

各国語サポート関数

SetUserGeoName