IMAPITable::GetStatus
Hace referencia a: Outlook 2013 | Outlook 2016
Devuelve el estado y el tipo de la tabla.
HRESULT GetStatus(
ULONG FAR * lpulTableStatus,
ULONG FAR * lpulTableType
);
Parameters
lpulTableStatus
[out] Puntero a un valor que indica el estado de la tabla. Se puede devolver uno de los valores siguientes:
TBLSTAT_COMPLETE
No hay ninguna operación en curso.
TBLSTAT_QCHANGED
El contenido de la tabla ha cambiado expectantemente. Este valor de estado no se devuelve para los cambios resultantes de operaciones de ordenación o restricción.
TBLSTAT_RESTRICT_ERROR
Error durante una operación IMAPITable::Restrict .
TBLSTAT_RESTRICTING
Una operación IMAPITable::Restrict está en curso.
TBLSTAT_SETCOL_ERROR
Error durante una operación IMAPITable::SetColumns .
TBLSTAT_SETTING_COLS
Hay una operación IMAPITable::SetColumns en curso.
TBLSTAT_SORT_ERROR
Error durante una operación IMAPITable::SortTable .
TBLSTAT_SORTING
Una operación IMAPITable::SortTable está en curso.
lpulTableType
[out] Puntero a un valor que indica el tipo de la tabla. Se puede devolver uno de los tres tipos de tabla siguientes:
TBLTYPE_DYNAMIC
El contenido de la tabla es dinámico; las filas y los valores de columna pueden cambiar a medida que cambian los datos subyacentes.
TBLTYPE_KEYSET
Las filas de la tabla son fijas, pero los valores de las columnas de estas filas son dinámicos y pueden cambiar a medida que cambian los datos subyacentes.
TBLTYPE_SNAPSHOT
La tabla es estática y su contenido no cambia cuando cambian los datos subyacentes.
Valor devuelto
S_OK
El estado de la tabla se devolvió correctamente.
Comentarios
El método IMAPTable::GetStatus recupera información sobre el tipo y el estado actual de una tabla.
Notas para los llamadores
Puede usar GetStatus junto con otros tres métodos IMAPITable para supervisar el estado de esas operaciones y determinar el efecto en la tabla. Llame a GetStatus después de realizar una de las siguientes llamadas IMAPITable :
IMAPITable::Restrict para establecer una restricción.
IMAPITable::SortTable para establecer un criterio de ordenación.
IMAPITable::SetColumns para definir un conjunto de columnas.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl::GetStatus |
MFCMAPI usa el método IMAPITable::GetStatus para notificar el estado de una tabla. |