Compartir a través de


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.

Vea también

MAPIAllocateBuffer

MAPIFreeBuffer

SPropValue

SRow

ITableData : IUnknown