SHEnumerateUnreadMailAccountsA-Funktion (shellapi.h)

Listet die Benutzerkonten auf, die ungelesene E-Mails enthalten.

Syntax

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

Parameter

[in, optional] hKeyUser

Typ: HKEY

Ein gültiger HKEY für einen bestimmten Benutzer.

dwIndex

Art: DWORD

Der Index des Benutzerkontos.

[out] pszMailAddress

Typ: LPTSTR

Ein Zeiger auf eine Unicode-Zeichenfolge, die die E-Mail-Adresse eines Kontos angibt, das dem angegebenen Benutzer gehört.

cchMailAddress

Typ: int

Die Anzahl der Zeichen in der E-Mail-Adresse.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der hKeyUser-Parameter ist der HKEY für den Stamm der Benutzerinformationen, z. B. HKEY_CURRENT_USER, oder ein beliebiger Schlüssel, der unter HKEY_USERS aufgelistet wird.

Hinweis

Der shellapi.h-Header definiert SHEnumerateUnreadMailAccounts als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shellapi.h
Bibliothek	Shell32.lib
DLL	Shell32.dll