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 |