EnumTimeFormatsA 関数 (winnls.h)
識別子で指定されたロケールで使用できる時間形式を列挙します。
構文
BOOL EnumTimeFormatsA(
[in] TIMEFMT_ENUMPROCA lpTimeFmtEnumProc,
[in] LCID Locale,
[in] DWORD dwFlags
);
パラメーター
[in] lpTimeFmtEnumProc
アプリケーション定義コールバック関数へのポインター。 詳細については、「EnumTimeFormatsProcを
[in] Locale
時間書式情報を取得するロケールを指定するロケール識別子。 MAKELCID マクロを使用してロケール識別子を作成するか、次のいずれかの定義済み値を使用できます。
- LOCALE_CUSTOM_DEFAULT
- LOCALE_CUSTOM_UI_DEFAULT
- LOCALE_CUSTOM_UNSPECIFIED
- LOCALE_INVARIANT
- LOCALE_SYSTEM_DEFAULT
- LOCALE_USER_DEFAULT
[in] dwFlags
時刻の形式。 このパラメーターは、次のいずれかの値の組み合わせを指定できます。
戻り値
成功した場合は 0 以外の値を返し、それ以外の場合は 0 を返します。 拡張エラー情報を取得するために、アプリケーションは GetLastError
- ERROR_INVALID_FLAGS。 フラグに指定された値が無効でした。
- ERROR_INVALID_PARAMETER。 パラメーター値のいずれかが無効でした。
備考
この関数は、時間形式を含むバッファーへのポインターをアプリケーション定義のコールバック関数に渡すことによって、時刻形式を列挙します。 列挙体の最初の値は、常にユーザーの既定値 (オーバーライド) 値です。 関数は、最後の時刻の形式が見つかるか、コールバック関数が FALSE
この関数は、カスタム ロケールからデータ
この関数の ANSI バージョンを Unicode のみのロケール識別子と共に使用すると、システムがシステム コード ページを使用するため、呼び出しは成功する可能性があります。 ただし、システム コード ページで未定義の文字は、文字列に疑問符 ("?") として表示されます。
将来的に導入
手記
winnls.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして EnumTimeFormats を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winnls.h (Windows.h を含む) |
| ライブラリ | Kernel32.lib |
| DLL | Kernel32.dll |
関連項目
EnumTimeFormatsEx の
EnumTimeFormatsProc の