ITableData::HrGetView
Hace referencia a: Outlook 2013 | Outlook 2016
Crea una vista de tabla y devuelve un puntero a una implementación IMAPITable .
HRESULT HrGetView(
LPSSortOrderSet lpSSortOrderSet,
CALLERRELEASE FAR * lpfCallerRelease,
ULONG_PTR ulCallerData,
LPMAPITABLE FAR * lppMAPITable
);
Parameters
lpSSortOrderSet
[in] Puntero a una estructura de criterio de ordenación que describe el criterio de ordenación de la vista de tabla. Si se pasa NULL en el parámetro lpSSortOrderSet , la vista no se ordena.
lpfCallerRelease
[in] Puntero a una función de devolución de llamada basada en el prototipo DE CALLERRELEASE al que MAPI llama cuando libera la vista. Si se pasa NULL en el parámetro lpfCallerRelease , no se llama a ninguna función al liberar la vista.
ulCallerData
[in] Datos que deben guardarse con la nueva vista y pasarse a la función de devolución de llamada a la que apunta lpfCallerRelease.
lppMAPITable
[out] Puntero a un puntero a la vista recién creada.
Valor devuelto
S_OK
La vista se creó correctamente.
Comentarios
El método ITableData::HrGetView crea una vista de solo lectura de los datos de la tabla, ordenada en el orden al que apunta el parámetro lpSSortOrderSet . El cursor se coloca al principio de la primera fila de la vista. Se devuelve una implementación de interfaz IMAPITable para acceder a la vista.
Los proveedores de servicios llaman a HrGetView cuando necesitan proporcionar a un cliente acceso a una tabla. HrGetView crea la vista y devuelve el puntero IMAPITable . A su vez, los proveedores de servicios pasan el puntero al cliente. Cuando el cliente termina de usar la tabla y llama a su método IUnknown::Release , HrGetView llama a la función de devolución de llamada a la que apunta el parámetro lpfCallerRelease .
Si un proveedor de servicios necesita devolver a un cliente una vista que tenga un conjunto de columnas personalizado o una restricción, el proveedor puede llamar a los métodos IMAPITable::SetColumns e IMAPITable::Restrict de la vista antes de permitir el acceso del cliente.