SHEnumerateUnreadMailAccountsA-Funktion (shellapi.h)

Artikel
11/20/2024

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

Typ: DWORD-

Der Index des Benutzerkontos.

[out] pszMailAddress

Typ: LPTSTR-

Ein Zeiger auf eine Unicode-Zeichenfolge, die die E-Mail-Adresse eines Kontos angibt, das zum 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, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.

Bemerkungen

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_USERSaufgelistet wird.

Anmerkung

Der shellapi.h-Header definiert SHEnumerateUnreadMailAccounts als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shellapi.h
Library	Shell32.lib
DLL-	Shell32.dll

Freigeben über