SHGetUnreadMailCountW 函式 (shellapi.h)

擷取任何或所有電子郵件帳戶的指定使用者未讀取訊息計數。

語法

HRESULT SHGetUnreadMailCountW(
  [in, optional]  HKEY     hKeyUser,
  [in, optional]  LPCWSTR  pszMailAddress,
  [out, optional] DWORD    *pdwCount,
  [out, optional] FILETIME *pFileTime,
  [out, optional] LPWSTR   pszShellExecuteCommand,
                  int      cchShellExecuteCommand
);

參數

[in, optional] hKeyUser

類型： HKEY

指定使用者的有效 HKEY。 如果在用戶的環境中呼叫函式，則此參數應該是 NULL ，在此情況下 會使用HKEY_CURRENT_USER 。 如果從 SYSTEM 內容呼叫函式，則此參數應該是 NULL ，在此情況下 會使用 HKEY_USERS\{SID} 。

[in, optional] pszMailAddress

類型： LPCTSTR

Unicode 中字串的指標，指定屬於指定使用者之帳戶的電子郵件位址。 當此參數為 NULL 時， pdwCount 會傳回指定用戶擁有之所有帳戶未讀取訊息的總計數。

[out, optional] pdwCount

類型： DWORD*

接收未讀取訊息計數的 DWORD 值指標。

[out, optional] pFileTime

類型： FILETIME*

FILETIME 結構的指標。 此參數的使用取決於 pszMailAddress 是否為 NULL。 如果 pszMailAddress 為 NULL，則此參數會被視為 [in] 參數，指定篩選條件，因此只會顯示比指定時間還新的未讀取郵件。 如果 pszMailAddress 不是 NULL，則會將此參數視為 [out] 參數，指向函式放置指定使用者和電子郵件帳戶上一個 SHSetUnreadMailCount 呼叫時間戳的 FILETIME 結構。

[out, optional] pszShellExecuteCommand

類型： LPCTSTR

字串的指標，這個字串會傳回傳遞至指定之使用者和電子郵件帳戶的最後一個 SHSetUnreadMailCount 呼叫中的 ShellExecute 命令語句。 此命令字串會啟動擁有 pszMailAddress 所參考帳戶的電子郵件應用程式。 如果不需要 ShellExecute 命令，這個參數可以是 NULL。 如果 pszMailAddress 為 NULL，則會忽略此參數，而且必須是 NULL。

cchShellExecuteCommand

類型： int

pszShellExecuteCommand 指向的ShellExecute命令緩衝區大小上限，以字元為單位。 當 pszMailAddress 為 NULL 時，這個參數必須為零。 每當不需要 ShellExecute 命令字串時，它也可以是 NULL 。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	shellapi.h
程式庫	Shell32.lib
Dll	Shell32.dll (6.0 版或更新版本)