Função SHEnumerateUnreadMailAccountsW (shellapi.h)

Artigo
11/20/2024

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

Sintaxe

HRESULT SHEnumerateUnreadMailAccountsW(
  [in, optional] HKEY   hKeyUser,
                 DWORD  dwIndex,
  [out]          LPWSTR 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 pertencente ao usuário especificado.

cchMailAddress

Tipo: int

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

Valor de retorno

Tipo: HRESULT

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

Observações

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

Nota

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. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	shellapi.h
biblioteca	Shell32.lib
de DLL	Shell32.dll

Compartilhar via