CfDisconnectSyncRoot-Funktion (cfapi.h)

  • Artikel

Trennt einen von CfConnectSyncRoot erstellten Kommunikationskanal.

Syntax

HRESULT CfDisconnectSyncRoot(
  [in] CF_CONNECTION_KEY ConnectionKey
);

Parameter

[in] ConnectionKey

Der von CfConnectSyncRoot zurückgegebene Verbindungsschlüssel, der jetzt zum Trennen des Synchronisierungsstamms verwendet wird.

Rückgabewert

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

Hinweise

Dadurch wird der Kommunikationskanal mit der Plattform entfernt, die zuvor mit CfConnectSyncRoot eingerichtet wurde.

Ein Synchronisierungsanbieter kann während des CfDisconnectSyncRoot-Aufrufs weiterhin Rückrufe empfangen, und der Anbieter kann wählen, ob der Anruf fehlschlagen oder gewartet werden muss. Beide Optionen verursachen keine Unterbrechungen für den Synchronisierungsanbieter.

Nachdem ein Aufruf von CfDisconnectSyncRoot zurückgegeben wurde, empfängt der Synchronisierungsanbieter keine Rückrufe mehr, und die Plattform schlägt jeden Vorgang fehl, der von diesen Rückrufen abhängig ist.

Ein Synchronisierungsanbieter sollte WRITE_DATA oder WRITE_DAC Zugriff auf den Synchronisierungsstamm haben, der getrennt werden soll, oder ein Aufruf von CfDisconnectSyncRoot schlägt mit HRESULT(ERROR_CLOUD_FILE_ACCESS_DENIED) fehl. Wenn der Synchronisierungsstamm zuvor nicht verbunden wurde, tritt beim Aufruf außerdem ein Fehler mit ungültigen Parametern auf. Diese API kann im Rahmen des ordnungsgemäßen Herunterfahrens des Synchronisierungsanbieters aufgerufen werden. Wenn der Synchronisierungsanbieterprozess jedoch ohne Aufruf dieser API beendet oder unerwartet abstürzt, erkennt die Plattform dies und führt die erforderliche Bereinigung durch.

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

CfConnectSyncRoot