SHSetUnreadMailCountA 関数 (shellapi.h)

指定したメールアカウントの現在のユーザーの未読メッセージ数をレジストリに格納します。

構文

HRESULT SHSetUnreadMailCountA(
  [in] LPCSTR pszMailAddress,
       DWORD  dwCount,
  [in] LPCSTR pszShellExecuteCommand
);

[in] pszMailAddress

型: LPCTSTR

現在のユーザーの完全な電子メールアドレスを含む Unicode の文字列へのポインター。

dwCount

型: DWORD

未読メッセージの数。

[in] pszShellExecuteCommand

型: LPCTSTR

ShellExecute に渡すことができるコマンドのフルテキストを含む Unicode の文字列へのポインター。このコマンドは、 pszMailAddress によって参照されるアカウントを所有する電子メールアプリケーションを起動する必要があります。

種類: HRESULT

HRESULT。これには、次の値が含まれます。

リターンコード	説明
S_OK	呼び出しは、正常に完了しました。
E_OUTOFMEMORY	使用できるメモリが不足しています。
E_INVALIDARG	pszMailAddress パラメーターまたは pszShellExecuteCommand パラメーターの文字列引数が無効です。

この関数がレジストリを更新すると、新しいレジストリエントリに現在の時刻と日付が自動的にスタンプされます。

この関数が、同じ電子メール名を指定する異なる独立系ソフトウェアベンダー (ISV) によって呼び出された場合、最後の呼び出しのみが保存されます。つまり、この関数の呼び出しは、異なる ISV によって呼び出しが行われた場合でも、同じメールアドレスに対して以前に保存された値を上書きします。

未読メッセージの数は、ユーザーアカウントのメイン受信トレイにのみ設定することをお勧めします。下書きや削除済みアイテムなどのサブフォルダー内のメールは無視する必要があります。

アプリケーションが終了すると、未読メッセージの数が 0 と誤って報告されるため、電子メールクライアントが未読メッセージの数を 0 に設定しないことが重要です。

この関数はHKEY_CURRENT_USERを使用するため、ユーザーを偽装するシステムプロセスでは呼び出さないでください。