SHSetUnreadMailCountW 関数 (shellapi.h)

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

構文

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

パラメーター

[in] pszMailAddress

型: LPCTSTR

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

dwCount

型: DWORD

未読メッセージの数。

[in] pszShellExecuteCommand

型: LPCTSTR

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

戻り値

種類: HRESULT

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

注釈

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

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

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

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

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

要件