CF_SYNC_STATUS-Struktur (cfapi.h)
Wird in einer CF_OPERATION_INFO-Struktur verwendet, um die status eines angegebenen Synchronisierungsstamms zu beschreiben.
Syntax
typedef struct CF_SYNC_STATUS {
ULONG StructSize;
ULONG Code;
ULONG DescriptionOffset;
ULONG DescriptionLength;
ULONG DeviceIdOffset;
ULONG DeviceIdLength;
} CF_SYNC_STATUS;
Member
StructSize
Die Größe der Synchronisierungsstruktur in Bytes status, einschließlich der tatsächlichen Beschreibungszeichenfolge.
Code
Die Verwendung dieses Parameters hängt vollständig vom Synchronisierungsanbieter ab, der dieses umfassende Synchronisierungs-status-Konstrukt unterstützt.
Für einen bestimmten Synchronisierungsanbieter wird erwartet, dass es eine 1:1-Zuordnung zwischen dem Code und der Beschreibungszeichenfolge gibt.
Es wird empfohlen, die höchste Bitreihenfolge zu verwenden, um den Typ des Fehlercodes zu beschreiben: 1 für einen Code auf Fehlerebene und 0 für einen Code auf Informationsebene.
Hinweis
Code ist für die Plattform undurchsichtig und wird nur zu Nachverfolgungszwecken verwendet.
DescriptionOffset
Der Offset der Beschreibungszeichenfolge relativ zum Anfang von CF_SYNC_STATUS. Sie verweist auf eine lokalisierte breite NULL-Zeichenfolge, die aussagekräftigere und umsetzbare Informationen zur betreffenden Datei enthält. Von Synchronisierungsanbietern wird erwartet, dass sie die Anforderung ausgleichen, mehr umsetzbare Informationen bereitzustellen und einen möglichst geringen Arbeitsspeicherbedarf beizubehalten.
DescriptionLength
Die Größe der Beschreibungszeichenfolge in Bytes, die den NULL-Abschlussator enthält.
DeviceIdOffset
Der Offset eines Geräte-ID-Blobs relativ zum Anfang von CF_SYNC_STATUS. Das Geräte-ID-Blob ist optional und für die Plattform undurchsichtig. Es wird erwartet, dass das Blob auf Gerätebasis eindeutig ist. Falls angegeben, wird das Blob als Teil der Plattformtelemetrie erfasst, um technische Probleme zu diagnostizieren.
DeviceIdLength
Die Größe des Geräte-ID-Blobs in Bytes.
Hinweise
Wenn im Feld SyncStatus einer CF_OPERATION_INFO-Struktur ein NULL-Zeiger festgelegt ist, löscht die Plattform die zuvor festgelegte Synchronisierungs-status, sofern vorhanden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1803 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Kopfzeile | cfapi.h |