Поделиться через

Функция SHSetUnreadMailCountW (shellapi.h)

  • Статья

Сохраняет количество непрочитанных сообщений текущего пользователя для указанной учетной записи электронной почты в реестре.

Синтаксис

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

Параметры

[in] pszMailAddress

Тип: LPCTSTR

Указатель на строку в Юникоде, содержащую полный адрес электронной почты текущего пользователя.

dwCount

Тип: DWORD

Количество непрочитанных сообщений.

[in] pszShellExecuteCommand

Тип: LPCTSTR

Указатель на строку в Юникоде, содержащую полный текст команды, которую можно передать в ShellExecute. Эта команда должна запустить почтовое приложение, которому принадлежит учетная запись, на которую ссылается pszMailAddress.

Возвращаемое значение

Тип: HRESULT

HRESULT, который включает следующие возможные значения.

Код возврата Описание
S_OK
 Вызов успешно завершен.
E_OUTOFMEMORY
 Недостаточно памяти.
E_INVALIDARG
 Недопустимый строковый аргумент в параметрах pszMailAddress или pszShellExecuteCommand .

Комментарии

Когда эта функция обновляет реестр, новая запись реестра автоматически помечена текущим временем и датой.

Если эта функция вызывается разными независимыми поставщиками программного обеспечения ( ISV), которые указывают одно и то же имя электронной почты, сохраняется только последний вызов. То есть вызовы этой функции перезаписывают все ранее сохраненные значения для того же адреса электронной почты, даже если вызовы выполняются разными независимыми поставщиками программного обеспечения.

Рекомендуется задавать количество непрочитанных сообщений только для main папки "Входящие" учетной записи пользователей. Почту во вложенных папках, таких как Черновики или Удаленные элементы, следует игнорировать.

Важно, чтобы почтовые клиенты не устанавливали число непрочитанных сообщений равным 0 при выходе из приложения, так как это приводит к ошибочному указанию числа непрочитанных сообщений как 0.

Так как эта функция использует HKEY_CURRENT_USER, она не должна вызываться системным процессом, олицетворяющим пользователя.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shellapi.h
Библиотека Shell32.lib
DLL Shell32.dll (версия 5.60 или более поздняя)