DownlevelLCIDToLocaleName 関数
Note
この関数は、Windows Vista 以前のオペレーティング システムで実行されるアプリケーションでのみ使用されます。 その使用にはダウンロード パッケージが必要です。 Windows Vista 以降でのみ実行されるアプリケーションでは、LCIDToLocaleName を呼び出してロケール名を取得する必要があります。
構文
int DownlevelLCIDToLocaleName(
_In_ LCID Locale,
_Out_ LPWSTR lpName,
_In_ int cchName,
_In_ DWORD dwFlags
);
パラメーター
-
Locale [in]
-
変換するロケール識別子。 MAKELCID マクロを使用して、ロケール識別子を作成できます。 この関数は、ニュートラル ロケールまたは次の特定のロケール識別子の値をサポートしていません。
-
lpName [out]
-
この関数がロケール名を取得するバッファーへのポインターです。 cchName が 0 に設定されている場合、この関数は NULL を取得します。
-
cchName [in]
-
ロケール名バッファーのサイズ (UTF-16 コード ポイント)。 ロケール名バッファーの必要なサイズを返すために、アプリケーションによりこのパラメーターが 0 に設定されます。
-
dwFlags [in]
-
取得する名前の種類を指定するフラグです。 既定値は、DOWNLEVEL_LOCALE_NAME です。
戻り値
成功した場合は、ロケール名内の UTF-16 コード ポイントの数 (終端の null 文字を含む) を返します。 関数が成功し、cchName の値が 0 の場合、戻り値は文字数で (null 文字を含め) ロケール名バッファーに必要なサイズになります。
成功しなかった場合、関数により 0 が返されます。 拡張エラー情報を取得するために、アプリケーションは、次のいずれかのエラー コードを返す GetLastError を呼び出すことができます。
- ERROR_INSUFFICIENT_BUFFER。 指定されたバッファー サイズが十分な大きさではなかったか、誤って NULL に設定されました。
- ERROR_INVALID_FLAGS。 dwFlags の値が無効です。
- ERROR_INVALID_PARAMETER。 パラメーター値のいずれかが無効でした。
解説
Note
この関数は、カスタム ロケールをサポートしていません。
必要なヘッダー ファイルと DLL は、Microsoft ダウンロード センターから入手できなくなった "Microsoft NLS ダウンレベル データ マッピング API" ダウンロードの一部です。 Windows 10 May 2019 Update 以降のバージョンでは、ICU グローバリゼーション API を使用してください。
要件
| 要件 | Value |
|---|---|
| サポートされている最小のクライアント |
Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー |
Windows Server 2003 (デスクトップ アプリのみ) |
| 再頒布可能パッケージ |
Windows XP with SP2 以降、または Windows Vista 上の Microsoft NLS ダウンレベル データ マッピング API |
| ヘッダー |
|
| [DLL] |
|
関連項目