Funzione SHGetUnreadMailCountA (shellapi.h)

Recupera il conteggio dei messaggi non letti di un utente specificato per qualsiasi account di posta elettronica o per tutti gli account di posta elettronica.

Sintassi

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

Parametri

[in, optional] hKeyUser

Tipo: HKEY

HKEY valido per un determinato utente. Questo parametro deve essere NULL se la funzione viene chiamata nell'ambiente di un utente, nel qual caso viene usata HKEY_CURRENT_USER . Questo parametro deve essere NULL se la funzione viene chiamata dal contesto SYSTEM, nel qual caso viene usato HKEY_USERS\{SID} .

[in, optional] pszMailAddress

Tipo: LPCTSTR

Puntatore a una stringa in Unicode che specifica l'indirizzo di posta elettronica di un account appartenente all'utente specificato. Quando questo parametro è NULL, pdwCount restituisce il numero totale di messaggi non letti per tutti gli account di proprietà dell'utente designato.

[out, optional] pdwCount

Tipo: DWORD*

Puntatore a un valore DWORD che riceve il numero di messaggi non letti.

[out, optional] pFileTime

Tipo: FILETIME*

Puntatore a una struttura FILETIME . L'uso di questo parametro è determinato dal fatto che pszMailAddress sia NULL. Se pszMailAddress è NULL, questo parametro viene considerato come parametro [in] che specifica un filtro, in modo che venga visualizzato solo un messaggio di posta elettronica non letto più recente rispetto all'ora specificata. Se pszMailAddress non è NULL, questo parametro viene considerato come parametro [out], che punta a una struttura FILETIME in cui la funzione inserisce il timestamp dell'ultima chiamata SHSetUnreadMailCount per l'account utente e di posta elettronica specificato.

[out, optional] pszShellExecuteCommand

Tipo: LPCTSTR

Puntatore a una stringa che restituisce l'istruzione del comando ShellExecute passata all'ultima chiamata SHSetUnreadMailCount per l'utente e l'account di posta elettronica specificati. Questa stringa di comando avvia l'applicazione di posta elettronica proprietaria dell'account a cui fa riferimento pszMailAddress. Se il comando ShellExecute non è obbligatorio, questo parametro può essere NULL. Se pszMailAddress è NULL, questo parametro viene ignorato e deve essere NULL.

cchShellExecuteCommand

Tipo: int

Dimensioni massime, in caratteri, del buffer dei comandi ShellExecute a cui punta pszShellExecuteCommand. Questo parametro deve essere zero per i conteggi totali quando pszMailAddress è NULL. Può anche essere NULL ogni volta che la stringa di comando ShellExecute non è necessaria.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti