SHEnumerateUnreadMailAccountsA 函数 (shellapi.h)

枚举具有未读电子邮件的用户帐户。

语法

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

参数

[in, optional] hKeyUser

类型:HKEY

给定用户的有效 HKEY。

dwIndex

类型:DWORD

用户帐户的索引。

[out] pszMailAddress

类型:LPTSTR

指向 Unicode 字符串的指针,该字符串指定属于指定用户帐户的电子邮件地址。

cchMailAddress

类型:int

电子邮件地址中的字符数。

返回值

类型:HRESULT

如果此函数成功,则返回 S_OK。 否则,它将返回 HRESULT 错误代码。

言论

hKeyUser 参数是用户信息的根目录(例如 HKEY_CURRENT_USER)或 HKEY_USERS下枚举的任何密钥的 HKEY。

注意

shellapi.h 标头将 SHEnumerateUnreadMailAccounts 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 shellapi.h
Shell32.lib
DLL Shell32.dll