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

Статья
11/20/2024

Перечисляет учетные записи пользователей, имеющие непрочитанные сообщения электронной почты.

Синтаксис

HRESULT SHEnumerateUnreadMailAccountsA(
  [in, optional] HKEY  hKeyUser,
                 DWORD dwIndex,
  [out]          LPSTR pszMailAddress,
                 int   cchMailAddress
);

Параметры

[in, optional] hKeyUser

Тип: HKEY

Допустимый HKEY для данного пользователя.

dwIndex

Тип: DWORD

Индекс учетной записи пользователя.

[out] pszMailAddress

Тип: LPTSTR

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

cchMailAddress

Тип: int

Количество символов в адресе электронной почты.

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

Тип: HRESULT

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

Замечания

Параметр hKeyUser — это HKEY для корня сведений пользователя, например HKEY_CURRENT_USER, или любой ключ, перечисленный в HKEY_USERS.

Заметка

Заголовок shellapi.h определяет SHEnumerateUnreadMailAccounts в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	shellapi.h
библиотеки	Shell32.lib
DLL	Shell32.dll

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