Fungsi EnumTimeFormatsEx (winnls.h)

Artikel
03/13/2024

Menghitung format waktu yang tersedia untuk lokal yang ditentukan oleh nama.

Catatan Aplikasi harus memanggil fungsi ini disukai enumTimeFormats jika dirancang untuk berjalan hanya di Windows Vista dan yang lebih baru.

Catatan Fungsi ini dapat menghitung data yang berubah di antara rilis, misalnya, karena lokal kustom. Jika aplikasi Anda harus mempertahankan atau mengirimkan data, lihat Menggunakan Data Lokal Persisten.

Sintaks

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

Parameter

[in] lpTimeFmtEnumProcEx

Penunjuk ke fungsi panggilan balik yang ditentukan aplikasi. Untuk informasi selengkapnya, lihat EnumTimeFormatsProcEx.

[in, optional] lpLocaleName

Arahkan ke nama lokal, atau salah satu nilai yang telah ditentukan sebelumnya berikut ini.

[in] dwFlags

Format waktu. Atur ke 0 untuk menggunakan format waktu lama pengguna saat ini, atau TIME_NOSECONDS (dimulai dengan Windows 7) untuk menggunakan format waktu singkat.

[in] lParam

Parameter yang disediakan aplikasi untuk diteruskan ke fungsi panggilan balik. Ini sangat berguna untuk aplikasi multi-utas.

Mengembalikan nilai

Mengembalikan nilai bukan nol jika berhasil, atau 0 sebaliknya. Untuk mendapatkan informasi kesalahan yang diperluas, aplikasi dapat memanggil GetLastError, yang dapat mengembalikan salah satu kode kesalahan berikut:

ERROR_INVALID_FLAGS. Nilai yang diberikan untuk bendera tidak valid.
ERROR_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.

Keterangan

Fungsi ini menghitung format waktu dengan meneruskan penunjuk string format waktu, satu per satu, ke fungsi panggilan balik yang ditentukan aplikasi yang ditentukan, bersama dengan konstanta yang ditentukan aplikasi yang berguna untuk aplikasi multi-utas. Nilai pertama dalam enumerasi selalu merupakan nilai default pengguna (ambil alih). Fungsi melanjutkan enumerasi hingga format terakhir kali ditemukan atau fungsi panggilan balik mengembalikan FALSE.

Dimulai di Windows 8: Jika aplikasi Anda meneruskan tag bahasa ke fungsi ini dari namespace Windows.Globalization, aplikasi harus terlebih dahulu mengonversi tag dengan memanggil ResolveLocaleName.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

EnumTimeFormats

EnumTimeFormatsProcEx

Dukungan Bahasa Nasional

Fungsi Dukungan Bahasa Nasional

Bagikan melalui