Compartir a través de

Función SHSetUnreadMailCountW (shellapi.h)

  • Artículo

Almacena el recuento de mensajes no leídos del usuario actual para una cuenta de correo electrónico especificada en el registro.

Sintaxis

HRESULT SHSetUnreadMailCountW(
  [in] LPCWSTR pszMailAddress,
       DWORD   dwCount,
  [in] LPCWSTR pszShellExecuteCommand
);

Parámetros

[in] pszMailAddress

Tipo: LPCTSTR

Puntero a una cadena en Unicode que contiene la dirección de correo electrónico completa del usuario actual.

dwCount

Tipo: DWORD

Número de mensajes no leídos.

[in] pszShellExecuteCommand

Tipo: LPCTSTR

Puntero a una cadena en Unicode que contiene el texto completo de un comando que se puede pasar a ShellExecute. Este comando debe iniciar la aplicación de correo electrónico propietaria de la cuenta a la que hace referencia pszMailAddress.

Valor devuelto

Tipo: HRESULT

HRESULT, que incluye los siguientes valores posibles.

Código devuelto Descripción
S_OK
 La llamada se ha realizado correctamente.
E_OUTOFMEMORY
 Memoria insuficiente.
E_INVALIDARG
 Argumento de cadena no válido en los parámetros pszMailAddress o pszShellExecuteCommand .

Comentarios

Cuando esta función actualiza el registro, la nueva entrada del Registro se marca automáticamente con la hora y la fecha actuales.

Si los distintos proveedores de software independientes (ISV) llaman a esta función que especifican el mismo nombre de correo electrónico, solo se guarda la última llamada. Es decir, las llamadas a esta función sobrescriben cualquier valor guardado previamente para la misma dirección de correo electrónico, incluso si las llamadas se realizan por diferentes ISV.

Se recomienda establecer el recuento de mensajes no leídos solo para la bandeja de entrada principal de la cuenta de usuarios. Se debe omitir el correo en subcarpetas, como borradores o elementos eliminados.

Es importante que los clientes de correo electrónico no establezcan el número de mensajes no leídos en 0 cuando se cierra la aplicación, ya que esto hace que el número de mensajes no leídos se notifique erróneamente como 0.

Dado que esta función usa HKEY_CURRENT_USER, un proceso del sistema no debe llamar a ella para suplantar a un usuario.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shellapi.h
Library Shell32.lib
Archivo DLL Shell32.dll (versión 5.60 o posterior)