CfGetCorrelationVector-Funktion (cfapi.h)
Ermöglicht dem Synchronisierungsanbieter, den aktuellen Korrelationsvektor für eine bestimmte Platzhalterdatei abzufragen. Dies ist entweder die, die automatisch von der Plattform zugewiesen wird, wenn die Datei zum ersten Mal geöffnet wurde, oder eine explizit über CfSetCorrelationVector zugewiesene.
Syntax
HRESULT CfGetCorrelationVector(
[in] HANDLE FileHandle,
[out] 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.
[out] CorrelationVector
Der Korrelationsvektor, der dem FileHandle derzeit zugeordnet ist.
Rückgabewert
Wenn diese Funktion erfolgreich ist, wird zurückgegeben S_OK. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Der Aufrufer muss READ_DATA oder WRITE_DAC Zugriff auf den Platzhalter haben, um aktiviert zu werden. Andernfalls tritt beim Vorgang ein Fehler mit STATUS_CLOUD_FILE_ACCESS_DENIED auf.
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 |