IMAPISupport::ModifyStatusRow
Hace referencia a: Outlook 2013 | Outlook 2016
Modifica la tabla de estado agregando una nueva fila o modificando una fila existente.
HRESULT ModifyStatusRow(
ULONG cValues,
LPSPropValue lpColumnVals,
ULONG ulFlags
);
Parameters
cValues
[in] Recuento de propiedades que se van a incluir en la fila de tabla de estado nueva o modificada.
lpColumnVals
[in] Puntero a una matriz de valores de propiedad que describen las propiedades que se van a incluir como columnas en la fila de tabla de estado nueva o modificada.
ulFlags
[in] Máscara de bits de marcas que controla cómo se procesa la información que define la fila de la tabla de estado. Se puede establecer la marca siguiente:
STATUSROW_UPDATE
Indica a MAPI que combine las propiedades incluidas en la matriz a la que apunta lpColumnVals con una fila de tabla de estado existente, en lugar de en una nueva fila.
Valor devuelto
S_OK
La tabla de estado se actualizó correctamente.
Comentarios
El método IMAPISupport::ModifyStatusRow se implementa para todos los objetos de soporte técnico del proveedor de servicios. Los proveedores de servicios llaman a ModifyStatusRow en el momento del inicio de sesión para agregar una fila a la tabla de estado y en otras ocasiones durante la sesión para actualizar la fila. ModifyStatusRow proporciona a MAPI la información necesaria para compilar la tabla de estado.
Notas para los llamadores
Establezca la marca STATUSROW_UPDATE al llamar a ModifyStatusRow para realizar cambios en las propiedades de la fila de la tabla de estado existente. Al hacerlo, se informa a MAPI de que solo se pasan las columnas que se están cambiando en el parámetro lpColumnVals .
Los clientes pueden usar la información de la tabla de estado para acceder al objeto de estado.
Para obtener una lista completa de las columnas que debe incluir en la fila de la tabla de estado, consulte Tablas de estado.