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

この関数は、カスタムロケールからデータを取得できます。データは、コンピューター間、またはアプリケーションの実行間で同じであるとは限りません。アプリケーションでデータを永続化または送信する必要がある場合は、「永続的なロケールデータの使用」を参照してください。

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