Fungsi SHSetUnreadMailCountA (shellapi.h)

Artikel
03/02/2024

Menyimpan jumlah pesan pengguna yang belum dibaca saat ini untuk akun email tertentu di registri.

Sintaks

HRESULT SHSetUnreadMailCountA(
  [in] LPCSTR pszMailAddress,
       DWORD  dwCount,
  [in] LPCSTR 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
S_OK	Panggilan berhasil diselesaikan.
E_OUTOFMEMORY	Tidak tersedia cukup memori.
E_INVALIDARG	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)

Bagikan melalui