ITableData::HrEnumRow
Hace referencia a: Outlook 2013 | Outlook 2016
Recupera una fila en función de su posición en la tabla.
HRESULT HrEnumRow(
ULONG ulRowNumber,
LPSRow FAR * lppSRow
);
Parameters
ulRowNumber
[in] Número de la fila para la que se devolverán las propiedades. El valor del parámetro ulRowNumber puede ser cualquier valor de 0, que indica la primera fila de la tabla, a través de n - 1, que indica la última fila de la tabla.
lppSRow
[out] Puntero a un puntero a una estructura SRow que describe la fila de destino.
Valor devuelto
S_OK
La fila se recuperó correctamente o no existe una fila para el número de fila especificado por el parámetro ulRowNumber .
Comentarios
El método ITableData::HrEnumRow recupera una fila basada en un número secuencial. Este número representa el orden de inserción (0 indica la primera fila y el número de filas menos 1 indica la última fila). MAPI mantiene este orden cronológico de inserción de filas durante la duración del objeto de datos de tabla.
Si el número especificado en ulRowNumber no corresponde a una fila de la tabla, HrEnumRow devuelve S_OK y establece el parámetro lppSRow en NULL.
MAPI asigna memoria para la estructura SRow devuelta mediante la función MAPIAllocateBuffer cuando se crea el objeto de datos de tabla. El autor de la llamada debe liberar esta memoria llamando a la función MAPIFreeBuffer .
Para recuperar filas de una tabla en el orden en que se insertaron, los usuarios de objetos de datos de tabla llaman al método HrEnumRow .