IMsgStore::GetReceiveFolderTable
Hace referencia a: Outlook 2013 | Outlook 2016
Proporciona acceso a la tabla de carpetas de recepción, una tabla que incluye información sobre todas las carpetas de recepción para el almacén de mensajes.
HRESULT GetReceiveFolderTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable );
Parameters
ulFlags
[in] Máscara de bits de marcas que controla el acceso a la tabla. Se pueden establecer las siguientes marcas:
MAPI_DEFERRED_ERRORS
Permite que GetReceiveFolderTable devuelva correctamente, posiblemente antes de que la tabla esté totalmente disponible para el autor de la llamada. Si la tabla no está totalmente disponible, realizar una llamada a la tabla posterior puede producir un error.
MAPI_UNICODE
Las cadenas devueltas están en formato Unicode. Si no se establece la marca de MAPI_UNICODE, las cadenas están en formato ANSI.
lppTable
[out] Puntero a un puntero a la tabla de carpetas de recepción.
Valor devuelto
S_OK
La tabla de carpetas de recepción se devolvió correctamente.
Comentarios
El método IMsgStore::GetReceiveFolderTable proporciona acceso a una tabla que muestra la configuración de propiedades de todas las carpetas de recepción del almacén de mensajes.
Notas a los implementadores
Para obtener una lista de las columnas necesarias en una tabla de carpetas de recepción, consulte Tablas de carpetas de recepción.
Implemente las tablas de carpetas de recepción para admitir la configuración de restricciones de propiedad en la propiedad PR_RECORD_KEY (PidTagRecordKey). Esto permite un fácil acceso a carpetas de recepción concretas.
Notas para los llamadores
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 |
|---|---|---|
| MsgStoreDlg.cpp |
CMsgStoreDlg::OnDisplayReceiveFolderTable |
MFCMAPI usa el método IMsgStore::GetReceiveFolderTable para obtener la tabla de carpetas de recepción que se va a mostrar. |