GetUserDefaultGeoName 関数 (winnls.h)

国際標準化機構 (ISO) 3166-1 の 2 文字コード (使用可能な場合) として、ユーザーの既定の地理的位置を取得します。それ以外の場合は、国連 (UN) シリーズ M、数値 49 (M.49) 数値コード。

構文

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

[out] geoName

この関数が null で終わる国際標準化機構 (ISO) 3166-1 の 2 文字コードまたは国連 (UN) シリーズ M、番号 49 (M.49) の数値コードを記述するバッファーへのポインター。

[in] geoNameCount

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

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

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

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

ユーザーの既定の地理的位置の ISO 3166-1 コードが 'XX' (コードが割り当てられていないことを示す) の場合、場所に UN M.49 コードが割り当てられている場合、M.49 コードは 10 進文字列として返されます。

ユーザーの既定の地理的位置の ISO 3166-1 コードが 'XX' (コードが割り当てられていないことを示します) であっても、その場所に UN M.49 コードが割り当てられている場合、M.49 コードは 10 進文字列として返されます。

2 文字の ISO 3166-1 コードの詳細については、「ISO 3166 国コードを参照してください。

数値の UN M.49 コードの詳細については、統計使用 (M49) の標準国または市外地域コードを参照してください。