Funzione SHSetUnreadMailCountW (shellapi.h)

Archivia il conteggio dei messaggi non letti dell'utente corrente per un account di posta elettronica specificato nel Registro di sistema.

Sintassi

HRESULT SHSetUnreadMailCountW(
  [in] LPCWSTR pszMailAddress,
       DWORD   dwCount,
  [in] LPCWSTR pszShellExecuteCommand
);

Parametri

[in] pszMailAddress

Tipo: LPCTSTR

Puntatore a una stringa in Unicode contenente l'indirizzo di posta elettronica completo dell'utente corrente.

dwCount

Tipo: DWORD

Numero di messaggi non letti.

[in] pszShellExecuteCommand

Tipo: LPCTSTR

Puntatore a una stringa in Unicode contenente il testo completo di un comando che può essere passato a ShellExecute. Questo comando deve avviare l'applicazione di posta elettronica a cui fa riferimento l'account a cui fa riferimento pszMailAddress.

Valore restituito

Tipo: HRESULT

HRESULT, che include i valori possibili seguenti.

Commenti

Quando questa funzione aggiorna il Registro di sistema, la nuova voce del Registro di sistema viene contrassegnata automaticamente con l'ora e la data correnti.

Se questa funzione viene chiamata da diversi fornitori di software indipendenti (ISV) che specificano lo stesso nome di posta elettronica, viene salvata solo l'ultima chiamata. Vale a dire, le chiamate a questa funzione sovrascrivono qualsiasi valore salvato in precedenza per lo stesso indirizzo di posta elettronica, anche se le chiamate vengono effettuate da isv diversi.

È consigliabile impostare il conteggio dei messaggi non letti solo per la posta in arrivo principale dell'account utenti. La posta in sottocartelle, ad esempio Bozze o Elementi eliminati, deve essere ignorata.

È importante che i client di posta elettronica non impostano il numero di messaggi non letti su 0 quando l'applicazione viene chiusa, perché questo causa il numero di messaggi non letti da segnalare erroneamente come 0.

Poiché questa funzione usa HKEY_CURRENT_USER, non deve essere chiamata da un processo di sistema che rappresenta un utente.

Requisiti