Freigeben über


SYNC_GID-Struktur

Stellt einen Bezeichner für ein in der Synchronisierungsgemeinschaft eindeutiges Element dar.

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

Member

  • ullGidPrefix
    Die Präfixkomponente der globalen ID.
  • guidUniqueId
    Die GUID-Komponente der globalen ID.

Hinweise

Die GUID-Komponente muss eindeutig sein. Dies kann erreicht werden, indem mit CoCreateGuid eine neue GUID generiert wird.

Element-IDs müssen nicht dieses Format haben. Für Systeme, die nicht über eine systeminterne eindeutige Element-ID verfügen, wird jedoch die Verwendung dieses Formats empfohlen.

In Situationen, in denen die zu synchronisierenden Elemente eine Hierarchie aufweisen, kann es sinnvoll sein, im ID-Präfix eine monoton steigende Zahl, z. B. die Uhrzeit, zu verwenden. Weitere Informationen hierzu finden Sie unter Flexible IDs.

Anforderungen

Header: Synchronization.h

Beispiel

Im folgenden Codebeispiel wird dargestellt, wie eine Element-ID abgerufen wird, die als SYNC_GID gespeichert ist.

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

Siehe auch

Konzepte

Kernkomponenten von Synchronization Framework
Flexible IDs