EnumTimeFormatsEx 関数 (winnls.h)

name で指定されたロケールで使用できる時刻形式を列挙します。

メモ アプリケーションは、Windows Vista 以降でのみ実行するように設計されている場合は 、EnumTimeFormats を優先してこの関数を呼び出す必要があります。
 
メモ この関数では、たとえばカスタム ロケールが原因でリリース間で変更されたデータを列挙できます。 アプリケーションでデータを永続化または送信する必要がある場合は、「 永続的なロケール データの使用」を参照してください。
 

構文

BOOL EnumTimeFormatsEx(
  [in]           TIMEFMT_ENUMPROCEX lpTimeFmtEnumProcEx,
  [in, optional] LPCWSTR            lpLocaleName,
  [in]           DWORD              dwFlags,
  [in]           LPARAM             lParam
);

パラメーター

[in] lpTimeFmtEnumProcEx

アプリケーション定義のコールバック関数へのポインター。 詳細については、「 EnumTimeFormatsProcEx」を参照してください。

[in, optional] lpLocaleName

ロケール名、または次のいずれかの定義済み値へのポインター。

[in] dwFlags

時刻の形式。 現在のユーザーの長い時間形式を使用する場合は 0 に設定し、短い時刻形式を使用するには TIME_NOSECONDS (Windows 7 以降) に設定します。

[in] lParam

コールバック関数に渡されるアプリケーション指定のパラメーター。 これは、マルチスレッド アプリケーションに特に役立ちます。

戻り値

成功した場合は 0 以外の値を返し、それ以外の場合は 0 を返します。 拡張エラー情報を取得するために、アプリケーションは GetLastError を呼び出すことができます。このエラー コードは、次のいずれかのエラー コードを返すことができます。

  • ERROR_INVALID_FLAGS。 フラグに指定された値が無効です。
  • ERROR_INVALID_PARAMETER。 パラメーター値のいずれかが無効です。

注釈

この関数は、指定したアプリケーション定義コールバック関数に時刻書式文字列ポインターを 1 つずつ渡し、マルチスレッド アプリケーションに役立つアプリケーション定義定数を渡すことによって、時刻形式を列挙します。 列挙体の最初の値は、常にユーザーの既定値 (オーバーライド) 値です。 関数は、最後の時刻形式が見つかるか、コールバック関数が FALSE を返すまで列挙を続行します。

Windows 8以降: アプリが Windows.Globalization 名前空間からこの関数に言語タグを渡す場合は、最初に ResolveLocaleName を呼び出してタグを変換する必要があります。

要件

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

関連項目

EnumTimeFormats

EnumTimeFormatsProcEx

各国語サポート

各国語サポート関数