IMAPITable::QueryColumns
Hace referencia a: Outlook 2013 | Outlook 2016
Devuelve una lista de columnas para la tabla.
HRESULT QueryColumns(
ULONG ulFlags,
LPSPropTagArray FAR * lpPropTagArray
);
Parameters
ulFlags
[in] Máscara de bits de marcas que indica qué conjunto de columnas se debe devolver. Se puede establecer la marca siguiente:
TBL_ALL_COLUMNS
La tabla debe devolver todas las columnas disponibles.
lpPropTagArray
[out] Puntero a una estructura SPropTagArray que contiene las etiquetas de propiedad del conjunto de columnas.
Valor devuelto
S_OK
El conjunto de columnas se devolvió correctamente.
MAPI_E_BUSY
Hay otra operación en curso que impide que se inicie la operación de recuperación del conjunto de columnas. Se debe permitir que se complete la operación en curso o se debe detener.
Comentarios
Se puede llamar al método IMAPITable::QueryColumns para recuperar:
Conjunto de columnas predeterminado para una tabla.
El conjunto de columnas actual de una tabla, tal como se establece mediante una llamada al método IMAPITable::SetColumns .
Conjunto de columnas completo para una tabla, las columnas que están disponibles, pero no necesariamente forman parte del conjunto actual.
Notas para los llamadores
Si no establece la marca de TBL_ALL_COLUMNS, IMAPITable::QueryColumns devuelve el conjunto de columnas predeterminado o actual de una tabla, en función de si la tabla se ha visto afectada por una llamada a IMAPITable::SetColumns. SetColumns cambia el orden y la selección de las columnas del conjunto de columnas de una tabla.
Si establece la marca de TBL_ALL_COLUMNS, QueryColumns devuelve todas las columnas que son capaces de estar en el conjunto de columnas de la tabla.
Libere la memoria de la matriz de etiquetas de propiedad a la que apunta el parámetro lpPropTagArray llamando a la función MAPIFreeBuffer .
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl::D oSetColumns |
MFCMAPI usa el método IMAPITable::QueryColumns para recuperar el conjunto de columnas actual de una tabla para que el usuario pueda editarlo. |