SetUserGeoName 関数 (winnls.h)

現在のユーザーの地理的な場所を、指定された 2 文字の国際標準化機構 (ISO) 3166-1 コードまたは数値の国連 (UN) シリーズ M、数値 49 (M.49) コードに設定します。

構文

BOOL SetUserGeoName(
  [in] PWSTR geoName
);

パラメーター

[in] geoName

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

戻り値

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。

この関数が成功しない場合は、次のいずれかのエラー コードを返す GetLastError を呼び出します。

リターン コード	説明
ERROR_ACCESS_DISABLED_BY_POLICY	コンピューターまたはユーザーのグループ ポリシーで、この操作が禁止されています。
ERROR_INTERNAL_ERROR	関数で予期しないエラーが発生しました。
ERROR_INVALID_PARAMETER	パラメーター値が無効です。

注釈

この関数は、特定のアプリケーションではなく、特定のユーザーの地理的な場所をレジストリに書き込みます。 このアクションは、ユーザーが実行する他のアプリケーションの動作に影響します。 原則として、この関数は、ユーザーが明示的に変更を要求した場合にのみ呼び出しますが、純粋にアプリケーション固有の理由では呼び出しません。

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

SetUserGeoName は、Windows 設定アプリなどのユーザー設定を変更するように設計されたアプリケーションで使用することを目的としています。 他のアプリケーションでは、この関数を呼び出さないでください。

要件

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

関連項目

EnumSystemGeoNames

GetUserDefaultGeoName

各国語サポート

各国語サポート関数

SetUserGeoID