IDestinationChangeVersionsBuilder::AddItemMetadata
Agrega un cambio de elemento especificado a la lista.
HRESULT AddItemMetadata(
const BYTE * pbOwnerReplicaId,
const BYTE * pbItemId,
const SYNC_VERSION * pChangeVersion,
const SYNC_VERSION * pCreationVersion,
DWORD dwFlags,
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 que se especifica 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.
- 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_POINTER
E_INVALIDARG si dwFlags contiene cualquier valor distinto de SYNC_CHANGE_FLAG_DELETED o SYNC_CHANGE_FLAG_DOES_NOT_EXIST.
SYNC_E_INVALID_OPERATION si se produce una operación no válida.
SYNC_E_ID_FORMAT_MISMATCH si el formato de pbOwnerReplicaId o pbItemId no coincide con el formato que se especifica en el esquema de formato de identificador del proveedor.
Ejemplo
En el ejemplo siguiente se muestra la forma de enumerar los cambios en un lote de cambios remoto y de crear una lista correspondiente de versiones locales utilizando AddItemMetadata para agregar las versiones locales a un objeto IDestinationChangeVersionsBuilder. En el ejemplo también se utiliza IDestinationChangeVersionsBuilder::GetChangeEnumerator para devolver la lista de versiones locales.
STDMETHODIMP CMetadataMgr::GetItemBatchVersions(
ISyncChangeBatch * pRemoteSyncChangeBatch,
IEnumSyncChanges ** ppLocalVersionsEnum)
{
HRESULT hr = E_UNEXPECTED;
if (NULL == pRemoteSyncChangeBatch || NULL == ppLocalVersionsEnum)
{
hr = E_POINTER;
}
else
{
IProviderSyncServices* pProvSvc;
hr = GetProviderSyncServices(&c_idParams, &pProvSvc);
if (SUCCEEDED(hr))
{
IDestinationChangeVersionsBuilder* pDestChangeBuilder = NULL;
hr = pProvSvc->CreateDestinationChangeVersionsBuilder(&pDestChangeBuilder);
if (SUCCEEDED(hr))
{
IEnumSyncChanges* pRemoteEnum = NULL;
hr = pRemoteSyncChangeBatch->GetChangeEnumerator(&pRemoteEnum);
if (SUCCEEDED(hr))
{
ULONG cFetched;
ISyncChange* pChange;
SYNC_GID gidItem;
DWORD cbID = sizeof(gidItem);
DWORD dwFlags;
SYNC_VERSION verCurrent;
SYNC_VERSION verCreation;
HRESULT hrEnum = S_OK;
while (S_OK == hrEnum && SUCCEEDED(hr))
{
pChange = NULL;
hrEnum = pRemoteEnum->Next(1, &pChange, &cFetched);
if (S_OK == hrEnum)
{
hr = pChange->GetRootItemId((BYTE*)&gidItem, &cbID);
if (SUCCEEDED(hr))
{
// Try to find the item in the local (destination) metadata.
IItemMetadata* pItem = NULL;
hr = FindItemMetadataByGlobalId((BYTE*)&gidItem, &pItem);
if (S_OK == hr)
{
// S_OK means the item exists in our local store.
// Extract its version and tombstone information.
dwFlags = 0;
BOOL fTombstone = FALSE;
hr = pItem->GetIsDeleted(&fTombstone);
if (SUCCEEDED(hr))
{
if (fTombstone)
{
dwFlags = SYNC_CHANGE_FLAG_DELETED;
}
}
if (SUCCEEDED(hr))
{
hr = pItem->GetChangeVersion(&verCurrent);
if (SUCCEEDED(hr))
{
hr = pItem->GetCreationVersion(&verCreation);
}
}
pItem->Release();
}
else if (S_FALSE == hr)
{
// S_FALSE means this item does not exist in our local store.
// Set versions to 0 and flag it as a new item.
verCurrent.dwLastUpdatingReplicaKey = 0;
verCurrent.ullTickCount = 0;
verCreation.dwLastUpdatingReplicaKey = 0;
verCreation.ullTickCount = 0;
dwFlags = SYNC_CHANGE_FLAG_DOES_NOT_EXIST;
}
if (SUCCEEDED(hr))
{
// Add the item to the batch of destination versions.
GUID guidReplicaID = GUID_NULL;
ULONG cbID = sizeof(guidReplicaID);
hr = GetReplicaId((BYTE*)&guidReplicaID, &cbID);
if (SUCCEEDED(hr))
{
hr = pDestChangeBuilder->AddItemMetadata((BYTE*)&guidReplicaID,
(BYTE*)&gidItem, &verCurrent, &verCreation, dwFlags, NULL);
}
}
}
pChange->Release();
}
}
if (FAILED(hrEnum))
{
hr = hrEnum;
}
pRemoteEnum->Release();
}
if (SUCCEEDED(hr))
{
hr = pDestChangeBuilder->GetChangeEnumerator(ppLocalVersionsEnum);
}
pDestChangeBuilder->Release();
}
pProvSvc->Release();
}
}
return hr;
}