CfUnregisterSyncRoot-Funktion (cfapi.h)

  • Artikel

Hebt die Registrierung eines zuvor registrierten Synchronisierungsstamms auf.

Syntax

HRESULT CfUnregisterSyncRoot(
  [in] LPCWSTR SyncRootPath
);

Parameter

[in] SyncRootPath

Der Pfad zum Synchronisierungsstamm, der die Registrierung aufheben soll.

Rückgabewert

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

Hinweise

Hebt die Registrierung eines Synchronisierungsstamms auf, der bei CfRegisterSyncRoot registriert wurde. Dies wird in der Regel zum Zeitpunkt der Deinstallation des Synchronisierungsanbieters bezeichnet, wenn ein Benutzerkonto gelöscht wird oder wenn ein Benutzer sich entscheidet, eine Verzeichnisstruktur nicht mehr zu synchronisieren (sofern vom Synchronisierungsanbieter unterstützt). Wenn der zu aufhebende Synchronisierungsstamm noch nie registriert wurde, schlägt die API mit STATUS_CLOUD_FILE_NOT_UNDER_SYNC_ROOT fehl.

Der Synchronisierungsanbieter sollte WRITE_DATA oder WRITE_DAC Zugriff auf den Synchronisierungsstamm haben, um die Registrierung aufzuheben, oder die Aufhebung der Registrierung schlägt mit HRESULT(ERROR_CLOUD_FILE_ACCESS_DENIED) fehl. Die Aufhebung der Registrierung schlägt auch mit HRESULT(ERROR_CLOUD_FILE_INVALID_REQUEST) fehl, wenn ein Synchronisierungsanbieter mit dem Synchronisierungsstamm verbunden ist.

Hebt die Registrierung eines Synchronisierungsstamms auf, indem die Verzeichnisstruktur des Synchronisierungsstamms durchläuft.

Für Platzhalterdateien:

  • Wenn eine Platzhalterdatei vollständig aktiviert ist, wird sie in eine "normale" Datei zurückgesetzt.
  • Wenn eine Platzhalterdatei nicht aktiviert ist, wird sie dauerhaft vom lokalen Computer gelöscht.

Für Platzhalterverzeichnisse:

  • Wenn ein Platzhalterverzeichnis vollständig aufgefüllt ist, wird es in ein "normales" Verzeichnis zurückgesetzt.
  • Wenn ein Platzhalterverzeichnis nicht vollständig aufgefüllt ist, wird das Verzeichnis dauerhaft vom lokalen Computer gelöscht.

Hinweis

Wenn die Platzhalterdateien oder Verzeichnisse nicht wiederhergestellt oder gelöscht werden können, werden sie übersprungen, und der Vorgang zum Aufheben der Registrierung wird fortgesetzt, bis die vollständige Synchronisierungsstammstruktur durchlaufen wurde.

Anforderungen

   
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

Siehe auch

CfRegisterSyncRoot