Fungsi SHSetUnreadMailCountW (shellapi.h)
Menyimpan jumlah pesan pengguna yang belum dibaca saat ini untuk akun email tertentu di registri.
Sintaks
HRESULT SHSetUnreadMailCountW(
[in] LPCWSTR pszMailAddress,
DWORD dwCount,
[in] LPCWSTR pszShellExecuteCommand
);
Parameter
[in] pszMailAddress
Jenis: LPCTSTR
Penunjuk ke string di Unicode yang berisi alamat email lengkap pengguna saat ini.
dwCount
Jenis: DWORD
Jumlah pesan yang belum dibaca.
[in] pszShellExecuteCommand
Jenis: LPCTSTR
Penunjuk ke string di Unicode yang berisi teks lengkap perintah yang dapat diteruskan ke ShellExecute. Perintah ini harus memulai aplikasi email yang memiliki akun yang direferensikan oleh pszMailAddress.
Nilai kembali
Jenis: HRESULT
HRESULT, yang mencakup kemungkinan nilai berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Panggilan berhasil diselesaikan. |
|
Tidak tersedia cukup memori. |
|
Argumen string tidak valid dalam parameter pszMailAddress atau pszShellExecuteCommand . |
Keterangan
Ketika fungsi ini memperbarui registri, entri registri baru secara otomatis ditandai dengan waktu dan tanggal saat ini.
Jika fungsi ini dipanggil oleh vendor perangkat lunak independen (ISV) yang berbeda yang menentukan nama email yang sama, hanya panggilan terakhir yang disimpan. Artinya, panggilan ke fungsi ini menimpa nilai yang disimpan sebelumnya untuk alamat email yang sama, bahkan jika panggilan dilakukan oleh ISV yang berbeda.
Disarankan agar jumlah pesan yang belum dibaca diatur hanya untuk Kotak Masuk utama akun pengguna. Email dalam sub-folder seperti Draf atau Item Terhapus harus diabaikan.
Penting bahwa klien email tidak mengatur jumlah pesan yang belum dibaca ke 0 ketika aplikasi keluar, karena ini menyebabkan jumlah pesan yang belum dibaca dilaporkan secara keliru sebagai 0.
Karena fungsi ini menggunakan HKEY_CURRENT_USER, fungsi ini tidak boleh dipanggil oleh proses sistem yang meniru pengguna.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | shellapi.h |
Pustaka | Shell32.lib |
DLL | Shell32.dll (versi 5.60 atau yang lebih baru) |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk