IMAPISession::GetMsgStoresTable
Hace referencia a: Outlook 2013 | Outlook 2016
Proporciona acceso a la tabla de almacén de mensajes que contiene información sobre todos los almacenes de mensajes del perfil de sesión.
HRESULT GetMsgStoresTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Parameters
ulFlags
[in] Máscara de bits de marcas que determina el formato de las columnas que son cadenas de caracteres. Se puede establecer la marca siguiente:
MAPI_UNICODE
Las columnas de cadena están en formato Unicode. Si no se establece la marca de MAPI_UNICODE, las columnas de cadena están en formato ANSI.
lppTable
[out] Puntero a un puntero a la tabla del almacén de mensajes.
Valor devuelto
S_OK
La tabla se devolvió correctamente.
MAPI_E_BAD_CHARWIDTH
Se estableció la marca de MAPI_UNICODE y la sesión no admite Unicode.
Comentarios
El método IMAPISession::GetMsgStoresTable recupera un puntero a la tabla del almacén de mensajes, una tabla mantenida por MAPI que contiene información sobre cada almacén de mensajes abierto del perfil.
Para obtener una lista completa de las columnas necesarias y opcionales en la tabla del almacén de mensajes, consulte Tablas del almacén de mensajes.
Notas para los llamadores
Dado que MAPI actualiza la tabla del almacén de mensajes durante la sesión cada vez que se producen cambios, llame al método Advise de la tabla del almacén de mensajes para registrarse para recibir una notificación de estos cambios. Entre los posibles cambios se incluyen la adición de nuevos almacenes de mensajes, la eliminación de los almacenes existentes y los cambios en el almacén predeterminado.
Establecer la marca MAPI_UNICODE en el parámetro ulFlags afecta al formato de las columnas devueltas por los métodos IMAPITable::QueryColumns e IMAPITable::QueryRows . Esta marca también controla los tipos de propiedad en el criterio de ordenación devuelto por el método IMAPITable::QuerySortOrder .
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MainDlg.cpp |
CMainDlg::OnOpenMessageStoreTable |
MFCMAPI usa el método IMAPISession::GetMsgStoresTable para obtener la tabla del almacén de mensajes de modo que se pueda representar en el cuadro de diálogo principal de MFCMAPI. |