CF_OPERATION_INFO-Struktur (cfapi.h)

Artikel
02/26/2024

Informationen zu einem Vorgang für eine Platzhalterdatei oder einen Ordner.

Syntax

typedef struct CF_OPERATION_INFO {
  ULONG                    StructSize;
  CF_OPERATION_TYPE        Type;
  CF_CONNECTION_KEY        ConnectionKey;
  CF_TRANSFER_KEY          TransferKey;
  const CORRELATION_VECTOR *CorrelationVector;
  const CF_SYNC_STATUS     *SyncStatus;
  CF_REQUEST_KEY           RequestKey;
} CF_OPERATION_INFO;

Member

StructSize

Die Größe der CF_OPERATION_INFO-Struktur .

Type

Der Typ des ausgeführten Vorgangs. Weitere Informationen finden Sie unter CF_OPERATION_TYPE .

ConnectionKey

Ein für den Kommunikationskanal abgerufener Verbindungsschlüssel.

TransferKey

Ein undurchsichtiges Handle für den Platzhalter.

CorrelationVector

Ein Korrelationsvektor für einen Platzhalter, der für Telemetriezwecke verwendet wird.

SyncStatus

Hinweis

Dieses Element ist neu für Windows 10 Version 1803.

Die aktuelle CF_SYNC_STATUS der Plattform.

Die Plattform fragt diese Informationen bei fehlgeschlagenen Vorgängen für einen Clouddateiplatzhalter ab. Wenn eine Struktur verfügbar ist, verwendet die Plattform die bereitgestellten Informationen, um eine aussagekräftigere und umsetzbarere Nachricht für den Benutzer zu erstellen. Die Plattform behält diese Informationen in der Datei bei, bis der letzte Handle darauf verschwindet. Wenn SyncStatusNULL ist, löscht die Plattform die zuvor festgelegte Synchronisierungs-status, sofern vorhanden.

RequestKey

Eine undurchsichtige ID, die einen Clouddateivorgang für eine bestimmte Clouddatei eindeutig identifiziert.

Hinweise

Die Plattform stellt connectionKey, TransferKey und CorrelationVector für alle Rückruffunktionen bereit, die über CfConnectSyncRoot registriert sind. Darüber hinaus können Synchronisierungsanbieter einen TransferKey mit CfGetTransferKey und einen CorrelationVector mit CfGetCorrelationVector abrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1709 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Kopfzeile	cfapi.h