ITableData::HrQueryRow
Hace referencia a: Outlook 2013 | Outlook 2016
Recupera una fila de tabla.
HRESULT HrQueryRow(
LPSPropValue lpSPropValue,
LPSRow FAR * lppSRow,
ULONG FAR * lpuliRow
);
Parameters
lpSPropValue
[in] Puntero a una estructura de valor de propiedad que describe la columna de índice de la fila que se va a recuperar. El miembro ulPropTag de la estructura de valores de propiedad debe contener la misma etiqueta de propiedad que el parámetro ulPropTagIndexColumn de la llamada a la función CreateTable , que tiene acceso a la implementación de ITableData .
lppSRow
[out] Puntero a un puntero a la fila recuperada.
lpuliRow
[entrada, salida] En la entrada, un puntero válido o NULL, que indica que no es necesario devolver información. En la salida, un puntero válido que apunta al número de fila de la fila, un número secuencial que identifica la posición de la fila en la tabla.
Valor devuelto
S_OK
La fila se recuperó correctamente.
MAPI_E_INVALID_PARAMETER
La estructura SPropValue a la que apunta lpSPropValue no contiene la propiedad de columna de índice.
Comentarios
El método ITableData::HrQueryRow recupera todas las propiedades de la fila que tiene una columna de índice que coincide con el valor de la columna de índice incluida en la estructura de propiedades a la que apunta lpSPropValue. HrQueryRow también devuelve el número de fila, si el autor de la llamada lo solicita, que identifica la posición de la fila en la tabla.
Dado que HrQueryRow no modifica la estructura SPropValue a la que apunta lpSPropValue, los autores de llamadas deben liberar la estructura cuando hrQueryRow devuelve. Los autores de llamadas también deben liberar la estructura SRow que contiene la fila recuperada.