Platform SDK: International Features

EnumDateFormatsProcEx

The EnumDateFormatsProcEx function is an application defined–callback function used with the EnumDateFormatsEx function. It receives a pointer to a buffer containing a date format string and a calendar identifier (CALID). The DATEFMT_ENUMPROCEX type defines a pointer to this callback function. EnumDateFormatsProc is a placeholder for the application defined–function name.

BOOL CALLBACK EnumDateFormatsProcEx (
  LPTSTR lpDateFormatString,  // date format string
  CALID  CalendarID           // calendar identifier
);

Parameters

lpDateFormatString
[in] Pointer to a buffer containing a null-terminated date format string. This string is a long or short date format, depending on the value of the dwFlags parameter passed to EnumDateFormatsEx.
CalendarID
[in] Calendar identifier associated with the date format string in lpDateFormatString. This parameter can be one of the following values.
Value Meaning
1 Gregorian (localized)
2 Gregorian (English strings always)
3 Era: Year of the Emperor (Japan)
4 Era: Year of Taiwan
5 Tangun Era (Korea)
6 Hijri (Arabic lunar)
7 Thai
8 Hebrew (Lunar)
9 Gregorian Middle East French calendar
10 Gregorian Arabic calendar
11 Gregorian Transliterated English calendar
12 Gregorian Transliterated French calendar

Return Values

To continue enumeration, the callback function should return TRUE.

To stop enumeration, the callback function should return FALSE.

Remarks

An EnumDateFormatsProcEx function can carry out any desired task. An application registers an EnumDateFormatsProcEx function by passing its address to the EnumDateFormatsEx function.

The date format strings are translated from Unicode to ANSI, for the ANSI version of this function, based on the default ANSI code page for the LCID. However, if LOCALE_USE_CP_ACP is specified, the translation is done using the system default ANSI code page.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 98.
  Header: Declared in Winnls.h; include Windows.h.

See Also

National Language Support Overview, National Language Support Functions, EnumDateFormatsEx