Funzione SHEnumerateUnreadMailAccountsW (shellapi.h)

Articolo
11/20/2024

Enumera gli account utente con messaggi di posta elettronica non letti.

Sintassi

HRESULT SHEnumerateUnreadMailAccountsW(
  [in, optional] HKEY   hKeyUser,
                 DWORD  dwIndex,
  [out]          LPWSTR 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.

Osservazioni

Il parametro hKeyUser è HKEY per la radice delle informazioni dell'utente, ad esempio HKEY_CURRENT_USERo 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shellapi.h
libreria	Shell32.lib
dll	Shell32.dll

Condividi tramite