SHGetUnreadMailCountA-Funktion (shellapi.h)

Ruft die Anzahl der ungelesenen Nachrichten eines angegebenen Benutzers für ein oder alle E-Mail-Konten ab.

Syntax

HRESULT SHGetUnreadMailCountA(
  [in, optional]  HKEY     hKeyUser,
  [in, optional]  LPCSTR   pszMailAddress,
  [out, optional] DWORD    *pdwCount,
  [out, optional] FILETIME *pFileTime,
  [out, optional] LPSTR    pszShellExecuteCommand,
                  int      cchShellExecuteCommand
);

Parameter

[in, optional] hKeyUser

Typ: HKEY

Ein gültiger HKEY für einen bestimmten Benutzer. Dieser Parameter sollte NULL sein, wenn die Funktion in der Umgebung eines Benutzers aufgerufen wird. In diesem Fall wird HKEY_CURRENT_USER verwendet. Dieser Parameter sollte NULL sein, wenn die Funktion aus dem SYSTEM-Kontext aufgerufen wird. In diesem Fall wird HKEY_USERS\{SID} verwendet.

[in, optional] pszMailAddress

Typ: LPCTSTR

Ein Zeiger auf eine Zeichenfolge in Unicode, die die E-Mail-Adresse eines Kontos angibt, das zum angegebenen Benutzer gehört. Wenn dieser Parameter NULL ist, gibt pdwCount die Gesamtanzahl der ungelesenen Nachrichten für alle Konten zurück, die dem angegebenen Benutzer gehören.

[out, optional] pdwCount

Typ: DWORD*

Zeiger auf einen DWORD-Wert, der die Anzahl der ungelesenen Nachrichten empfängt.

[out, optional] pFileTime

Typ: FILETIME*

Ein Zeiger auf eine FILETIME-Struktur . Die Verwendung dieses Parameters wird dadurch bestimmt, ob pszMailAddressNULL ist. Wenn pszMailAddressNULL ist, wird dieser Parameter als [in]-Parameter behandelt, der einen Filter angibt, sodass nur ungelesene E-Mails angezeigt werden, die neuer als die angegebene Zeit sind. Wenn pszMailAddress nicht NULL ist, wird dieser Parameter als [out]-Parameter behandelt, der auf eine FILETIME-Struktur verweist, in der die Funktion den Zeitstempel des letzten SHSetUnreadMailCount-Aufrufs für den angegebenen Benutzer und E-Mail-Konto platziert.

[out, optional] pszShellExecuteCommand

Typ: LPCTSTR

Ein Zeiger auf eine Zeichenfolge, die die ShellExecute-Befehlsanweisung zurückgibt, die an den letzten SHSetUnreadMailCount-Aufruf für den angegebenen Benutzer und das angegebene E-Mail-Konto übergeben wurde. Mit dieser Befehlszeichenfolge wird die E-Mail-Anwendung gestartet, die das Konto besitzt, auf das von pszMailAddress verwiesen wird. Wenn der ShellExecute-Befehl nicht erforderlich ist, kann dieser Parameter NULL sein. Wenn pszMailAddressNULL ist, wird dieser Parameter ignoriert und muss NULL sein.

cchShellExecuteCommand

Typ: int

Die maximale Größe des ShellExecute-Befehlspuffers in Zeichen, auf die mit pszShellExecuteCommand verwiesen wird. Dieser Parameter muss null für die Gesamtanzahl sein, wenn pszMailAddressNULL ist. Es kann auch NULL sein, wenn die ShellExecute-Befehlszeichenfolge nicht erforderlich ist.

Rückgabewert

Typ: HRESULT

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

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 (Version 6.0 oder höher)