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