Función SHGetUnreadMailCountA (shellapi.h)

Recupera el recuento de mensajes no leídos de un usuario especificado para cualquiera o todas las cuentas de correo electrónico.

Sintaxis

HRESULT SHGetUnreadMailCountA(
  [in, optional]  HKEY     hKeyUser,
  [in, optional]  LPCSTR   pszMailAddress,
  [out, optional] DWORD    *pdwCount,
  [out, optional] FILETIME *pFileTime,
  [out, optional] LPSTR    pszShellExecuteCommand,
                  int      cchShellExecuteCommand
);

Parámetros

[in, optional] hKeyUser

Tipo: HKEY

HKEY válido para un usuario determinado. Este parámetro debe ser NULL si se llama a la función en el entorno de un usuario, en cuyo caso se usa HKEY_CURRENT_USER . Este parámetro debe ser NULL si se llama a la función desde el contexto SYSTEM, en cuyo caso se usa HKEY_USERS\{SID} .

[in, optional] pszMailAddress

Tipo: LPCTSTR

Puntero a una cadena en Unicode que especifica la dirección de correo electrónico de una cuenta que pertenece al usuario especificado. Cuando este parámetro es NULL, pdwCount devuelve el recuento total de mensajes no leídos para todas las cuentas que pertenecen al usuario designado.

[out, optional] pdwCount

Tipo: DWORD*

Puntero a un valor DWORD que recibe el recuento de mensajes no leídos.

[out, optional] pFileTime

Tipo: FILETIME*

Puntero a una estructura FILETIME . El uso de este parámetro viene determinado por si pszMailAddress es NULL. Si pszMailAddress es NULL, este parámetro se trata como un parámetro [in], que especifica un filtro, de modo que solo aparezca un correo no leído más reciente que la hora especificada. Si pszMailAddress no es NULL, este parámetro se trata como un parámetro [out], que apunta a una estructura FILETIME en la que la función coloca la marca de tiempo de la última llamada SHSetUnreadMailCount para el usuario y la cuenta de correo electrónico especificadas.

[out, optional] pszShellExecuteCommand

Tipo: LPCTSTR

Puntero a una cadena que devuelve la instrucción de comando ShellExecute pasada a la última llamada SHSetUnreadMailCount para el usuario y la cuenta de correo electrónico especificadas. Esta cadena de comando inicia la aplicación de correo electrónico propietaria de la cuenta a la que hace referencia pszMailAddress. Si no se requiere el comando ShellExecute, este parámetro puede ser NULL. Si pszMailAddress es NULL, este parámetro se omite y debe ser NULL.

cchShellExecuteCommand

Tipo: int

Tamaño máximo, en caracteres, del búfer de comandos ShellExecute al que apunta pszShellExecuteCommand. Este parámetro debe ser cero para los recuentos totales cuando pszMailAddress es NULL. También puede ser NULL siempre que la cadena de comandos ShellExecute no sea necesaria.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos