SHEnumerateUnreadMailAccountsW-Funktion (shellapi.h)

Artikel
03/01/2024

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

Syntax

HRESULT SHEnumerateUnreadMailAccountsW(
  [in, optional] HKEY   hKeyUser,
                 DWORD  dwIndex,
  [out]          LPWSTR 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 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_OK zurückgegeben. 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 aufgezählt wird.

Hinweis

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
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

Share via