Partilhar via


Estrutura SYNC_GID

Representa um identificador para um item que é exclusivo ao longo da comunidade de sincronização.

typedef struct _SYNC_GID
{
  ULONGLONG ullGidPrefix;
  GUID guidUniqueId;
} SYNC_GID;

Membros

  • ullGidPrefix
    O componente de prefixo da ID global.
  • guidUniqueId
    O componente GUID da ID global.

Comentários

O componente GUID deve ser exclusivo. Isso pode ser feito pelo uso de CoCreateGuid para gerar um novo GUID.

IDs de itens não precisam estar neste formato. Porém, para sistemas que não têm uma ID exclusiva intrínseca para itens, recomendamos o uso deste formato.

Em situações nas quais os itens em sincronização possuem uma hierarquia, é útil colocar no prefixo da ID números que aumentam de forma monotônica, como a hora de um relógio. Para obter mais informações, consulte IDs flexíveis.

Requisitos

Cabeçalho: Synchronization.h

Exemplo

O exemplo a seguir mostra como obter uma ID de item armazenada como um SYNC_GID.

SYNC_GID gidItem;
DWORD cbID = sizeof(gidItem);
hr = pChange->GetRootItemId((BYTE*)&gidItem, &cbID);

Consulte também

Conceitos

Componentes principais do Sync Framework
IDs flexíveis