SHSetUnreadMailCountW 函式 (shellapi.h)

將目前使用者的未讀取訊息計數儲存在登錄中指定的電子郵件帳戶。

語法

HRESULT SHSetUnreadMailCountW(
  [in] LPCWSTR pszMailAddress,
       DWORD   dwCount,
  [in] LPCWSTR pszShellExecuteCommand
);

[in] pszMailAddress

類型： LPCTSTR

Unicode 中字串的指標，其中包含目前使用者的完整電子郵件位址。

dwCount

類型： DWORD

未讀取的訊息數目。

[in] pszShellExecuteCommand

類型： LPCTSTR

Unicode 中字串的指標，其中包含可傳遞至ShellExecute之命令的全文檢索。此命令應該會啟動擁有 pszMailAddress 所參考帳戶的電子郵件應用程式。

類型： HRESULT

HRESULT，其中包含下列可能的值。

傳回碼	描述
S_OK	呼叫已順利完成。
E_OUTOFMEMORY	可用的記憶體不足。
E_INVALIDARG	pszMailAddress 或 pszShellExecuteCommand 參數中的字串自變數無效。

當此函式更新登錄時，新的登錄專案會自動加上目前時間和日期的戳記。

如果不同的獨立軟體廠商呼叫此函式， (ISV) 指定相同的電子郵件名稱，則只會儲存最後一次呼叫。也就是說，呼叫此函式會覆寫相同電子郵件位址先前儲存的任何值，即使呼叫是由不同的ISV進行。

建議只針對用戶帳戶的主要收件匣設定未讀取訊息的計數。應該忽略子資料夾中的郵件，例如草稿或刪除的專案。

電子郵件客戶端在應用程式結束時不會將未讀取訊息的數目設定為 0，因為這會導致未讀取的訊息數目錯誤地回報為 0。

因為此函式會使用 HKEY_CURRENT_USER，所以系統進程不應該呼叫它模擬使用者。