EnumTimeFormatsEx

名前で指定されたロケールで利用可能な時刻形式を列挙する。注: Windows Vista 以降でのみ動作するように設計されている場合、アプリケーションは EnumTimeFormats よりもこの関数を呼び出すべきである。注: この関数はカスタムロケールなどによりリリース間で変化するデータを列挙することがある。アプリケーションがデータを永続化または送信しなければならない場合は Using Persistent Locale Data を参照。

EnumTimeFormatsEx lpTimeFmtEnumProcEx, lpLocaleName, dwFlags, lParam

lpTimeFmtEnumProcEx : [int] アプリケーション定義のコールバック関数へのポインタ。詳細は EnumTimeFormatsProcEx を参照。
lpLocaleName : [wstr] ロケール名へのポインタ、または以下の定義済み値のいずれか。
dwFlags : [int] 時刻形式。現在のユーザーの長い時刻形式を使用するには 0 に、Windows 7 以降の短い時刻形式を使用するには TIME_NOSECONDS に設定する。
lParam : [intptr] コールバック関数に渡すアプリケーション提供のパラメータ。これはマルチスレッドアプリケーションで特に有用である。

(プラグイン / モジュール : kernel32.dll)

解説

名前で指定されたロケールで利用可能な時刻形式を列挙する。注: Windows Vista
以降でのみ動作するように設計されている場合、アプリケーションは EnumTimeFormats よりもこの関数を呼び出すべきである。注:
この関数はカスタムロケールなどによりリリース間で変化するデータを列挙することがある。アプリケーションがデータを永続化または送信しなければならない場合は
Using Persistent Locale Data を参照。

[戻り値]
成功した場合 0 以外、それ以外の場合 0 を返す。拡張エラー情報を取得するには、アプリケーションは GetLastError
を呼ぶことができ、次のいずれかのエラーコードを返すことがある。
（以下省略）

[備考]
この関数は、時刻形式文字列ポインタを 1
つずつ、指定されたアプリケーション定義のコールバック関数に渡し、マルチスレッドアプリケーションで有用なアプリケーション定義の定数と共に時刻形式を列挙する。列挙の最初の値は常にユーザーデフォルト（オーバーライド）値である。関数は最後の時刻形式が見つかるか、コールバック関数が
FALSE を返すまで列挙を続ける。Windows 8 以降: アプリが Windows.Globalization
名前空間からこの関数に言語タグを渡す場合、まず ResolveLocaleName を呼んでタグを変換しなければならない。

情報