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

Функция 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 . Этот параметр должен иметь значение NULL , если функция вызывается из контекста SYSTEM, и в этом случае используется HKEY_USERS\{SID} .

[in, optional] pszMailAddress

Тип: LPCTSTR

Указатель на строку в Юникоде, указывающую адрес электронной почты учетной записи, принадлежащей указанному пользователю. Если этот параметр имеет значение NULL, функция pdwCount возвращает общее количество непрочитанных сообщений для всех учетных записей, принадлежащих указанному пользователю.

[out, optional] pdwCount

Тип: DWORD*

Указатель на значение DWORD, которое получает число непрочитанных сообщений.

[out, optional] pFileTime

Тип: FILETIME*

Указатель на структуру FILETIME . Использование этого параметра определяется тем, имеет ли pszMailAddressзначение NULL. Если pszMailAddress имеет значение NULL, то этот параметр обрабатывается как параметр [in], который задает фильтр, чтобы отображались только непрочитанные сообщения, которые новее указанного времени. Если pszMailAddress не равно NULL, этот параметр обрабатывается как параметр [out], указывающий на структуру FILETIME , в которую функция помещает метку времени последнего вызова SHSetUnreadMailCount для указанного пользователя и учетной записи электронной почты.

[out, optional] pszShellExecuteCommand

Тип: LPCTSTR

Указатель на строку, которая возвращает командную инструкцию ShellExecute, переданную в последний вызов SHSetUnreadMailCount для указанного пользователя и учетной записи электронной почты. Эта строка команды запускает почтовое приложение, которому принадлежит учетная запись, на которую ссылается pszMailAddress. Если команда ShellExecute не является обязательной, этот параметр может иметь значение NULL. Если pszMailAddress имеет значение NULL, этот параметр игнорируется и должен иметь значение NULL.

cchShellExecuteCommand

Тип: int

Максимальный размер (в символах) буфера команд ShellExecute, на который указывает pszShellExecuteCommand. Если pszMailAddress имеет значение NULL, этот параметр должен быть равен нулю. Он также может иметь значение NULL , если командная строка ShellExecute не требуется.

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

Тип: HRESULT

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Требования

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