CfSetCorrelationVector-Funktion (cfapi.h)

  • Artikel

Ermöglicht einem Synchronisierungsanbieter, die Plattform anzuweisen, einen bestimmten Korrelationsvektor für Telemetriezwecke für eine Platzhalterdatei zu verwenden. Diese Eingabe ist optional.

Syntax

HRESULT CfSetCorrelationVector(
  [in] HANDLE                    FileHandle,
  [in] const PCORRELATION_VECTOR CorrelationVector
);

Parameter

[in] FileHandle

Das Handle für die Platzhalterdatei. Die Plattform synchronisiert den Vorgang ordnungsgemäß mit anderen aktiven Anforderungen. Ein Attribut oder kein Zugriffshandle ist ausreichend.

[in] CorrelationVector

Ein spezifischer Korrelationsvektor, der dem FileHandle zugeordnet werden soll.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird zurückgegeben S_OK. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die Plattform weist jeder Datei beim ersten Öffnen automatisch einen Korrelationsvektor zu und stellt diesen Korrelationsvektor mit jedem Rückruf an den Synchronisierungsanbieter als Teil der allgemeinen CF_CALLBACK_INFO bereit. Es wird empfohlen, dass die Synchronisierungs-Engine diese Funktion aufruft, um die letzte Ziffer des Korrelationsvektors "Uhr" zu erhöhen, während der Synchronisierungsanbieter interne Phasen (wie vom Synchronisierungsanbieter definiert) durchläuft, um die Anforderung zu erfüllen.

Anforderungen

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

Weitere Informationen

CF_CALLBACK_INFO