CfSetCorrelationVector-Funktion (cfapi.h)
Ermöglicht einem Synchronisierungsanbieter, die Plattform anzuweisen, einen bestimmten Korrelationsvektor für Telemetriezwecke für eine Platzhalterdatei zu verwenden. Diese Eingabe ist optional.
HRESULT CfSetCorrelationVector(
[in] HANDLE FileHandle,
[in] const PCORRELATION_VECTOR CorrelationVector
);
[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.
Wenn diese Funktion erfolgreich ist, wird zurückgegeben S_OK. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
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.
| 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 |