Recuperar datos de filas de tabla
Hace referencia a: Outlook 2013 | Outlook 2016
La recuperación de filas de una tabla implica lo siguiente:
Obtener los valores de propiedad de todas las columnas.
Modificación de la posición actual.
Una de las columnas necesarias en la mayoría de las tablas es un identificador de entrada (la propiedad PR_ENTRYID (PidTagEntryId) que se puede usar para abrir el objeto que representa la fila. Este identificador de entrada suele ser un identificador de entrada a corto plazo, uno que no persiste más allá de la duración de la tabla. Sin embargo, puede ser un identificador a largo plazo si el proveedor de servicios que implementa la tabla solo admite un tipo de identificador de entrada.
Los clientes y proveedores de servicios pueden realizar una de las siguientes llamadas para recuperar filas:
| Llamar | Descripción |
|---|---|
|
IMAPITable::QueryRows |
Recupera un número especificado de filas a partir de la fila actual en dirección hacia delante o hacia atrás. |
|
HrQueryAllRows |
Recupera todas las filas de una tabla. |
|
ITableData::HrQueryRow |
Recupera una fila de una tabla según el valor de su columna de índice. PR_INSTANCE_KEY (PidTagInstanceKey) suele ser la columna de índice de una tabla. |
Cuando se incluye una propiedad opcional como una de las columnas de una tabla, algunas de las filas pueden tener valores válidos para la columna, mientras que otras podrían no. Si existe un valor válido para una columna depende de si el objeto que proporciona la información de la fila establece la propiedad . En función de la implementación del objeto, una propiedad inexistente se puede representar en la tabla como PR_NULL (PidTagNull) o un valor arbitrario. Los usuarios de tablas deben tener cuidado de diferenciar entre las propiedades que son inexistentes y tienen valores y propiedades sin sentido que existen y tienen valores válidos.