SHSetUnreadMailCountA-Funktion (shellapi.h)

Artikel
03/02/2024

Speichert die Anzahl der ungelesenen Nachrichten des aktuellen Benutzers für ein angegebenes E-Mail-Konto in der Registrierung.

Syntax

HRESULT SHSetUnreadMailCountA(
  [in] LPCSTR pszMailAddress,
       DWORD  dwCount,
  [in] LPCSTR pszShellExecuteCommand
);

Parameter

[in] pszMailAddress

Typ: LPCTSTR

Ein Zeiger auf eine Zeichenfolge in Unicode, die die vollständige E-Mail-Adresse des aktuellen Benutzers enthält.

dwCount

Art: DWORD

Die Anzahl der ungelesenen Nachrichten.

[in] pszShellExecuteCommand

Typ: LPCTSTR

Ein Zeiger auf eine Zeichenfolge in Unicode, die den vollständigen Text eines Befehls enthält, der an ShellExecute übergeben werden kann. Dieser Befehl sollte die E-Mail-Anwendung starten, die besitzer des Kontos ist, auf das von pszMailAddress verwiesen wird.

Rückgabewert

Typ: HRESULT

HRESULT, das die folgenden möglichen Werte enthält.

Rückgabecode	BESCHREIBUNG
S_OK	Der Aufruf wurde erfolgreich abgeschlossen.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher verfügbar.
E_INVALIDARG	Ungültiges Zeichenfolgenargument in den Parametern pszMailAddress oder pszShellExecuteCommand .

Hinweise

Wenn diese Funktion die Registrierung aktualisiert, wird der neue Registrierungseintrag automatisch mit der aktuellen Uhrzeit und dem aktuellen Datum gestempelt.

Wenn diese Funktion von verschiedenen unabhängigen Softwareanbietern (Independent Software Vendors, ISVs) aufgerufen wird, die denselben E-Mail-Namen angeben, wird nur der letzte Aufruf gespeichert. Das heißt, Aufrufe dieser Funktion überschreiben jeden zuvor gespeicherten Wert für dieselbe E-Mail-Adresse, auch wenn die Aufrufe von verschiedenen ISVs erfolgen.

Es wird empfohlen, die Anzahl der ungelesenen Nachrichten nur für den Standard Posteingang des Benutzerkontos festzulegen. E-Mails in Unterordnern wie Entwürfe oder Gelöschte Elemente sollten ignoriert werden.

Es ist wichtig, dass E-Mail-Clients die Anzahl der ungelesenen Nachrichten nicht auf 0 festlegen, wenn die Anwendung beendet wird, da dies dazu führt, dass die Anzahl der ungelesenen Nachrichten fälschlicherweise als 0 gemeldet wird.

Da diese Funktion HKEY_CURRENT_USER verwendet, sollte sie nicht von einem Systemprozess aufgerufen werden, der die Identität eines Benutzers angibt.

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 5.60 oder höher)

Freigeben über