ISyncChangeBatchBase::AddItemMetadataToGroup

Agrega el cambio de elemento especificado al grupo que se encuentra abierto.

HRESULT AddItemMetadataToGroup(
  const BYTE * pbOwnerReplicaId, 
  const BYTE * pbItemId, 
  const SYNC_VERSION * pChangeVersion,
  const SYNC_VERSION * pCreationVersion, 
  DWORD dwFlags,
  DWORD dwWorkForChange,
  ISyncChangeBuilder ** ppChangeBuilder);

Parámetros

  • pbOwnerReplicaId
    [in] Identificador de la réplica donde pChangeVersion y pCreationVersion son válidos. El formato del identificador debe coincidir con el formato especificado en la estructura ID_PARAMETERS del proveedor.
  • pbItemId
    [in] Identificador del elemento. El formato del identificador debe coincidir con el formato que se especifica en la estructura ID_PARAMETERS del proveedor.
  • pChangeVersion
    [in] Versión de este cambio.
  • pCreationVersion
    [in] Versión de creación del elemento.
  • dwFlags
    [in] Marcadores que especifican el estado del cambio de elemento. Para obtener más información sobre los valores de los marcadores, vea Marcadores SYNC_CHANGE_FLAG.
  • dwWorkForChange
    [in] Estimación de trabajo para el cambio. Este valor se utiliza durante la aplicación de los cambios para notificar a la aplicación que el trabajo se ha completado.
  • ppChangeBuilder
    [out] Devuelve un objeto que se puede usar para agregar información de la unidad de cambio al cambio.

Valor devuelto

  • S_OK

  • E_INVALIDARG si dwFlags contiene un valor de marcador no válido.

  • SYNC_E_INVALID_OPERATION si no hay ningún grupo abierto, o si anteriormente se agregó un grupo vacío al lote.

  • SYNC_E_RANGE_OUT_OF_ORDER si un grupo ordenado está abierto y pbItemId es menor que el identificador del elemento anterior que se agregó al grupo o menor que el identificador de elemento que se especificó al abrir el grupo.

  • SYNC_E_CHANGE_BATCH_IS_READ_ONLY si el objeto ISyncChangeBatchBase se ha enviado a un aplicador de cambios o a la sesión de sincronización, o si el objeto se creó con IProviderSyncServices::DeserializeChangeBatch o IProviderSyncServices::DeserializeFullEnumerationChangeBatch.

Vea también

Referencia

Interfaz ISyncChangeBatchBase
Estructura SYNC_VERSION

Conceptos

Notificar el progreso de la sincronización