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 を呼び出します。GetLastError は、次のいずれかのエラーコードを返すことができます。

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

注釈

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

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

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

Requirements

Requirement	価値
サポートされる最小クライアント	Windows 10 バージョン 1709 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2016 [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
Header	winnls.h (Windows.h を含む)
Library	Kernel32.lib
DLL	Kernel32.dll