GetUserDefaultLocaleName 関数 (winnls.h)
ユーザーの既定の ロケール名を取得します。
メモ アプリケーションは、Windows Vista 以降でのみ実行するように設計されている場合は 、GetUserDefaultLCID を優先してこの関数を呼び出す必要があります。
構文
int GetUserDefaultLocaleName(
[out] LPWSTR lpLocaleName,
[in] int cchLocaleName
);
パラメーター
[out] lpLocaleName
この関数がロケール名を取得するバッファーへのポインター。
[in] cchLocaleName
lpLocaleName で示されるバッファーのサイズ (文字数)。 ロケール名の最大長 (終端の null 文字を含む) は LOCALE_NAME_MAX_LENGTH。 これは、このパラメーターで指定する推奨サイズです。
戻り値
成功した場合は、終端の null 文字を含むロケール名を含むバッファーのサイズを返します。
メモ シングル ユーザー システムでは、戻り値は GetSystemDefaultLocaleName によって返される戻り値と同じです。
成功しなかった場合、関数は 0 を返します。 拡張エラー情報を取得するために、アプリケーションは GetLastError を呼び出すことができます。このエラー コードは、次のいずれかのエラー コードを返すことができます。
- ERROR_INSUFFICIENT_BUFFER。 指定されたバッファー サイズが十分な大きさではなかったか、 正しく NULL に設定されていません。
注釈
この関数は、 カスタム ロケールからデータを取得できます。 データは、コンピューター間、またはアプリケーションの実行間で同じであるとは限りません。 アプリケーションでデータを永続化または送信する必要がある場合は、「 永続的なロケール データの使用」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ | UWP アプリ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | winnls.h (Windows.h を含む) |
Library | Kernel32.lib |
[DLL] | Kernel32.dll |