SHGetUnreadMailCountW

指定したユーザーの未読メッセージ数を、任意またはすべてのメールアカウントについて取得する。(Unicode)

SHGetUnreadMailCountW hKeyUser, pszMailAddress, pdwCount, pFileTime, pszShellExecuteCommand, cchShellExecuteCommand

hKeyUser : [intptr] 型: HKEY 指定したユーザーに対する有効な HKEY。関数がユーザーの環境で呼び出される場合はこのパラメーターを NULL にすべきで、その場合は HKEY_CURRENT_USER が使用される。関数が SYSTEM コンテキストから呼び出される場合もこのパラメーターを NULL にすべきで、その場合は HKEY_USERS\{SID} が使用される。
pszMailAddress : [wstr] 型: LPCTSTR 指定したユーザーに属するアカウントのメールアドレスを指定する Unicode 文字列へのポインター。このパラメーターが NULL の場合、pdwCount は指定したユーザーが所有するすべてのアカウントの未読メッセージの合計数を返す。
pdwCount : [var] 型: DWORD* 未読メッセージ数を受け取る DWORD 値へのポインター。
pFileTime : [var] 型: FILETIME* FILETIME 構造体へのポインター。このパラメーターの使用方法は pszMailAddress が NULL かどうかで決まる。pszMailAddress が NULL の場合、このパラメーターは [in] パラメーターとして扱われ、フィルターを指定するため、指定した時刻より新しい未読メールのみが表示されるようになる。pszMailAddress が NULL でない場合、このパラメーターは [out] パラメーターとして扱われ、指定したユーザーおよびメールアカウントに対する直近の SHSetUnreadMailCount 呼び出しのタイムスタンプを関数が格納する FILETIME 構造体を指す。
pszShellExecuteCommand : [wstr] 型: LPCTSTR 指定したユーザーおよびメールアカウントに対する直近の SHSetUnreadMailCount 呼び出しに渡された ShellExecute コマンド文を返す文字列へのポインター。このコマンド文字列は pszMailAddress で参照されるアカウントを所有するメールアプリケーションを起動する。ShellExecute コマンドが必要ない場合、このパラメーターは NULL でもよい。pszMailAddress が NULL の場合、このパラメーターは無視され、NULL でなければならない。
cchShellExecuteCommand : [int] 型: int pszShellExecuteCommand が指す ShellExecute コマンドバッファーの最大サイズ (文字単位)。pszMailAddress が NULL の合計カウント取得時には、このパラメーターはゼロでなければならない。ShellExecute コマンド文字列が必要ない場合は NULL でもよい。

(プラグイン / モジュール : shell32.dll)

解説

指定したユーザーの未読メッセージ数を、任意またはすべてのメールアカウントについて取得する。(Unicode)

[戻り値]
型: HRESULT この関数が成功した場合は S_OK を返す。失敗した場合は HRESULT エラーコードを返す。

情報