Funzione CfDisconnectSyncRoot (cfapi.h)
Disconnette un canale di comunicazione creato da CfConnectSyncRoot.
Sintassi
HRESULT CfDisconnectSyncRoot(
[in] CF_CONNECTION_KEY ConnectionKey
);
Parametri
[in] ConnectionKey
La chiave di connessione restituita da CfConnectSyncRoot ora utilizzata per disconnettere la radice di sincronizzazione.
Valore restituito
Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Ciò rimuove il canale di comunicazione con la piattaforma stabilita in precedenza usando CfConnectSyncRoot.
Un provider di sincronizzazione può comunque ricevere callback durante la chiamata CfDisconnectSyncRoot e il provider è libero di scegliere se la chiamata deve avere esito negativo o essere serviced. La scelta non causerà interruzioni al provider di sincronizzazione.
Dopo aver restituito una chiamata a CfDisconnectSyncRoot , il provider di sincronizzazione non riceverà più i callback e la piattaforma avrà esito negativo in qualsiasi operazione che dipende dai callback.
Un provider di sincronizzazione deve avere WRITE_DATA o WRITE_DAC l'accesso alla radice di sincronizzazione da disconnettersi o una chiamata a CfDisconnectSyncRoot non sarà riuscita con HRESULT(ERROR_CLOUD_FILE_ACCESS_DENIED). Inoltre, se la radice di sincronizzazione non è stata connessa in precedenza, la chiamata non sarà riuscita con parametri non validi. Questa API può essere chiamata come parte dell'arresto normale del provider di sincronizzazione. Tuttavia, se il processo del provider di sincronizzazione sceglie di terminare senza chiamare questa API o arresti anomali imprevisti, la piattaforma rileverà questa operazione ed eseguirà la pulizia necessaria.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10 versione 1709 [solo app desktop] |
| Server minimo supportato | Windows Server 2016 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | cfapi.h |
| Libreria | CldApi.lib |
| DLL | CldApi.dll |