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

関連項目

GetLocaleInfoEx

GetSystemDefaultLocaleName

GetUserDefaultLCID

各国語サポート

各国語サポート関数