Função SHEnumerateUnreadMailAccountsA (shellapi.h)

  • Artigo

Enumera as contas de usuário que têm emails não lidos.

Sintaxe

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

Parâmetros

[in, optional] hKeyUser

Tipo: HKEY

Um HKEY válido para um determinado usuário.

dwIndex

Tipo: DWORD

O índice da conta de usuário.

[out] pszMailAddress

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres Unicode que especifica o endereço de email de uma conta que pertence ao usuário especificado.

cchMailAddress

Tipo: int

O número de caracteres no endereço de email.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O parâmetro hKeyUser é o HKEY para a raiz das informações do usuário, por exemplo , HKEY_CURRENT_USER ou qualquer chave enumerada em HKEY_USERS.

Observação

O cabeçalho shellapi.h define SHEnumerateUnreadMailAccounts como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shellapi.h
Biblioteca Shell32.lib
DLL Shell32.dll