CfRevertPlaceholder-Funktion (cfapi.h)

Stellt einen Platzhalter wieder in eine reguläre Datei zurück, wobei alle besonderen Merkmale wie das Reparse-Tag, die Dateiidentität usw. entfernt werden.

Syntax

HRESULT CfRevertPlaceholder(
  [in]                HANDLE          FileHandle,
  [in]                CF_REVERT_FLAGS RevertFlags,
  [in, out, optional] LPOVERLAPPED    Overlapped
);

Parameter

[in] FileHandle

Ein Handle für den Datei- oder Verzeichnisplatzhalter, der in eine normale Datei oder ein normales Verzeichnis zurückgesetzt werden soll. Die Plattform synchronisiert den rückgängig machen-Vorgang ordnungsgemäß mit anderen aktiven Anforderungen. Ein Attribut oder kein Zugriffshandle ist ausreichend.

[in] RevertFlags

Platzhalter rückgängig machen Flags. RevertFlags sollte auf CF_REVERT_FLAG_NONE festgelegt werden.

[in, out, optional] Overlapped

Bei Angabe und Kombination mit einem asynchronen FileHandle ermöglicht Overlapped der Plattform die asynchrone Ausführung des CfRevertPlaceholder-Aufrufs . Weitere Informationen finden Sie in den Anmerkungen .

Falls nicht angegeben, führt die Plattform den API-Aufruf synchron aus, unabhängig davon, wie das Handle erstellt wurde.

Rückgabewert

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

Hinweise

Der Aufrufer muss WRITE_DATA oder WRITE_DAC Zugriff auf den Platzhalter haben, um wiederhergestellt zu werden.

Wenn der Platzhalter zum Zeitpunkt des Aufrufs noch nicht vollständig hydratisiert ist, sendet der Filter einen FETCH_DATA Rückruf an den Synchronisierungsanbieter, um die Datei zu hydrieren. Wenn die Datei nicht hydriert werden kann, schlägt die rückgängig machen mit status STATUS_CLOUD_FILE_ACCESS_DENIED fehl.

Wenn die API bei asynchroner Verwendung von Overlapped HRESULT_FROM_WIN32(ERROR_IO_PENDING) zurückgibt, kann der Aufrufer dann mit GetOverlappedResult warten.

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

GetOverlappedResult

CF_REVERT_FLAGS