Funzione SHEnumerateUnreadMailAccountsA (shellapi.h)

Articolo
03/05/2024

Enumera gli account utente con posta elettronica non letti.

Sintassi

HRESULT SHEnumerateUnreadMailAccountsA(
  [in, optional] HKEY  hKeyUser,
                 DWORD dwIndex,
  [out]          LPSTR pszMailAddress,
                 int   cchMailAddress
);

Parametri

[in, optional] hKeyUser

Tipo: HKEY

HKEY valido per un determinato utente.

dwIndex

Tipo: DWORD

Indice dell'account utente.

[out] pszMailAddress

Tipo: LPTSTR

Puntatore a una stringa Unicode che specifica l'indirizzo di posta elettronica di un account appartenente all'utente specificato.

cchMailAddress

Tipo: int

Numero di caratteri nell'indirizzo di posta elettronica.

Valore restituito

Tipo: HRESULT

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

Commenti

Il parametro hKeyUser è HKEY per la radice delle informazioni dell'utente, ad esempio HKEY_CURRENT_USER o qualsiasi chiave enumerata in HKEY_USERS.

Nota

L'intestazione shellapi.h definisce SHEnumerateUnreadMailAccounts come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shellapi.h
Libreria	Shell32.lib
DLL	Shell32.dll

Condividi tramite