Fungsi SHGetUnreadMailCountA (shellapi.h)

Artikel
03/01/2024

Mengambil jumlah pesan pengguna yang belum dibaca tertentu untuk salah satu atau semua akun email.

Sintaks

HRESULT SHGetUnreadMailCountA(
  [in, optional]  HKEY     hKeyUser,
  [in, optional]  LPCSTR   pszMailAddress,
  [out, optional] DWORD    *pdwCount,
  [out, optional] FILETIME *pFileTime,
  [out, optional] LPSTR    pszShellExecuteCommand,
                  int      cchShellExecuteCommand
);

Parameter

[in, optional] hKeyUser

Jenis: HKEY

HKEY yang valid untuk pengguna tertentu. Parameter ini harus NULL jika fungsi dipanggil di lingkungan pengguna, dalam hal ini HKEY_CURRENT_USER digunakan. Parameter ini harus NULL jika fungsi dipanggil dari konteks SYSTEM, dalam hal ini HKEY_USERS\{SID} digunakan.

[in, optional] pszMailAddress

Jenis: LPCTSTR

Penunjuk ke string di Unicode yang menentukan alamat email akun milik pengguna yang ditentukan. Ketika parameter ini NULL, pdwCount mengembalikan jumlah total pesan yang belum dibaca untuk semua akun yang dimiliki oleh pengguna yang ditunjuk.

[out, optional] pdwCount

Jenis: DWORD*

Penunjuk ke nilai DWORD yang menerima jumlah pesan yang belum dibaca.

[out, optional] pFileTime

Jenis: FILETIME*

Penunjuk ke struktur FILETIME . Penggunaan parameter ini ditentukan oleh apakah pszMailAddress ADALAH NULL. Jika pszMailAddressadalah NULL, maka parameter ini diperlakukan sebagai parameter [in], yang menentukan filter, sehingga hanya email yang belum dibaca yang lebih baru dari waktu yang ditentukan yang muncul. Jika pszMailAddress bukan NULL, maka parameter ini diperlakukan sebagai parameter [out], yang menunjuk ke struktur FILETIME tempat fungsi menempatkan tanda waktu panggilan SHSetUnreadMailCount terakhir untuk pengguna dan akun email yang ditentukan.

[out, optional] pszShellExecuteCommand

Jenis: LPCTSTR

Penunjuk ke string yang mengembalikan pernyataan perintah ShellExecute yang diteruskan ke panggilan SHSetUnreadMailCount terakhir untuk pengguna dan akun email yang ditentukan. String perintah ini memulai aplikasi email yang memiliki akun yang direferensikan oleh pszMailAddress. Jika perintah ShellExecute tidak diperlukan, parameter ini bisa NULL. Jika pszMailAddressNULL, parameter ini diabaikan dan harus NULL.

cchShellExecuteCommand

Jenis: int

Ukuran maksimum, dalam karakter, dari buffer perintah ShellExecute yang diarahkan oleh pszShellExecuteCommand. Parameter ini harus nol untuk jumlah total ketika pszMailAddress adalah NULL. Ini juga bisa NULL setiap kali string perintah ShellExecute tidak diperlukan.

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

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 6.0 atau yang lebih baru)

Bagikan melalui