Compartir a través de


ISimpleSyncProvider::UpdateItem

Lo llama el motor en tiempo de ejecución de Sync Framework para actualizar un elemento en el almacén de destino.

HRESULT UpdateItem(
  IUnknown *pItemData,
  const CHANGE_UNIT_SET *pChangeUnitsToUpdate,
  const ITEM_FIELDS *pKeyAndExpectedVersionInfo,
  IRecoverableErrorCallback *pRecoverableErrorCallback,
  ITEM_FIELDS **ppUpdatedKeyAndVersionInfo,
  BOOL *pfCommitKnowledgeAfterThisItem);

Parámetros

  • pItemData
    [in] Datos para el elemento en el formato específico del proveedor.
  • pChangeUnitsToUpdate
    [in, unique] Objeto CHANGE_UNIT_SET que contiene las unidades de cambio que se han de actualizar en un elemento. El parámetro debe ser nulo (no vacío) si no se especifica ninguna unidad de cambio.
  • pKeyAndExpectedVersionInfo
    [in] Propiedades de clave y de versión esperada del elemento que se va a actualizar.

    El proveedor debe realizar una comprobación de simultaneidad optimista para comprobar que la versión del elemento del destino se corresponde con los valores de pKeyAndExpectedVersionInfo. Si se produce un error en esta comprobación, el proveedor debe notificar un error recuperable.

  • pRecoverableErrorCallback
    [in] Objeto IRecoverableErrorCallback que contiene métodos a los que se puede llamar si se produce un error recuperable durante la actualización de un elemento.
  • ppUpdatedKeyAndVersionInfo
    [out] Devuelve las propiedades de clave y de versión actualizada de los elementos actualizados. Si el valor devuelto es no válido, el motor en tiempo de ejecución de Sync Framework finaliza la sesión.
  • pfCommitKnowledgeAfterThisItem
    [out] Indica si el motor en tiempo de ejecución de Sync Framework debe confirmar el conocimiento en el almacén de metadatos cuando se completa el procesamiento del elemento especificado.

Valor devuelto

  • S_OK

Vea también

Referencia

Interfaz ISimpleSyncProvider