Fungsi EnumTimeFormatsW (winnls.h)

Artikel
03/08/2023

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

Catatan Untuk alasan interoperabilitas, aplikasi harus lebih memilih fungsi EnumTimeFormatsEx ke EnumTimeFormats karena Microsoft bermigrasi ke penggunaan nama lokal alih-alih pengidentifikasi lokal untuk lokal baru. Aplikasi apa pun yang hanya berjalan di Windows Vista dan yang lebih baru harus menggunakan EnumTimeFormatsEx.

Sintaks

BOOL EnumTimeFormatsW(
  [in] TIMEFMT_ENUMPROCW lpTimeFmtEnumProc,
  [in] LCID              Locale,
  [in] DWORD             dwFlags
);

Parameter

[in] lpTimeFmtEnumProc

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

[in] Locale

Pengidentifikasi lokal yang menentukan lokal untuk mengambil informasi format waktu. Anda bisa menggunakan makro MAKELCID untuk membuat pengidentifikasi lokal atau menggunakan salah satu nilai yang telah ditentukan sebelumnya berikut ini.

[in] dwFlags

Format waktu. Parameter ini dapat menentukan kombinasi salah satu nilai berikut.

Bendera	Makna
0	Gunakan format waktu panjang pengguna saat ini.
TIME_NOSECONDS	Windows 7 dan yang lebih baru: Gunakan format waktu singkat pengguna saat ini. Catatan Nilai ini tidak akan berfungsi dengan versi ANSI dari fungsi ini, EnumTimeFormatsA.
LOCAL_USE_CP_ACP	Ditentukan dengan versi ANSI dari fungsi ini, EnumTimeFormatsA (tidak disarankan ), untuk menggunakan halaman kode Windows ANSI default sistem (ACP) alih-alih halaman kode lokal.

Nilai kembali

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 menghitung format waktu dengan meneruskan penunjuk ke buffer yang berisi format waktu ke fungsi panggilan balik yang ditentukan aplikasi. 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.

Fungsi ini dapat menghitung data dari lokal kustom. Data tidak dijamin sama dari komputer ke komputer atau antara eksekusi aplikasi. Jika aplikasi Anda harus mempertahankan atau mengirimkan data, lihat Menggunakan Data Lokal Persisten.

Ketika versi ANSI dari fungsi ini digunakan dengan pengidentifikasi lokal khusus Unicode, panggilan dapat berhasil karena sistem menggunakan halaman kode sistem. Namun, karakter yang tidak ditentukan di halaman kode sistem muncul dalam string sebagai tanda tanya ("?"). Perhatikan bahwa setiap nilai baru untuk dwFlags yang diperkenalkan di masa mendatang tidak akan berfungsi dengan versi ANSI.

Catatan

Header winnls.h mendefinisikan EnumTimeFormats sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

EnumTimeFormatsEx

EnumTimeFormatsProc

Dukungan Bahasa Nasional

Fungsi Dukungan Bahasa Nasional

Bagikan melalui