Função SHSetUnreadMailCountA (shellapi.h)

Armazena a contagem de mensagens não lidas do usuário atual para uma conta de email especificada no registro.

Sintaxe

HRESULT SHSetUnreadMailCountA(
  [in] LPCSTR pszMailAddress,
       DWORD  dwCount,
  [in] LPCSTR pszShellExecuteCommand
);

Parâmetros

[in] pszMailAddress

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres em Unicode que contém o endereço de email completo do usuário atual.

dwCount

Tipo: DWORD

O número de mensagens não lidas.

[in] pszShellExecuteCommand

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres em Unicode que contém o texto completo de um comando que pode ser passado para ShellExecute. Esse comando deve iniciar o aplicativo de email que possui a conta referenciada por pszMailAddress.

Retornar valor

Tipo: HRESULT

HRESULT, que inclui os valores possíveis a seguir.

Código de retorno	Descrição
S_OK	Chamada concluída com êxito.
E_OUTOFMEMORY	Memória insuficiente disponível.
E_INVALIDARG	Argumento de cadeia de caracteres inválido nos parâmetros pszMailAddress ou pszShellExecuteCommand .

Comentários

Quando essa função atualiza o registro, a nova entrada do Registro é automaticamente carimbada com a hora e a data atuais.

Se essa função for chamada por DIFERENTES ISVs (fornecedores independentes de software) que especificam o mesmo nome de email, somente a última chamada será salva. Ou seja, as chamadas para essa função substituem qualquer valor salvo anteriormente para o mesmo endereço de email, mesmo que as chamadas sejam feitas por ISVs diferentes.

É recomendável que a contagem de mensagens não lidas seja definida apenas para a Caixa de Entrada main da conta de usuários. Emails em subpastas, como Rascunhos ou Itens Excluídos, devem ser ignorados.

É importante que os clientes de email não definam o número de mensagens não lidas como 0 quando o aplicativo for encerrado, pois isso faz com que o número de mensagens não lidas seja relatado erroneamente como 0.

Como essa função usa HKEY_CURRENT_USER, ela não deve ser chamada por um processo do sistema representando um usuário.

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 (versão 5.60 ou posterior)