CfDisconnectSyncRoot 函式 (cfapi.h)

中斷 CfConnectSyncRoot 所建立的通道連線。

語法

HRESULT CfDisconnectSyncRoot(
  [in] CF_CONNECTION_KEY ConnectionKey
);

參數

[in] ConnectionKey

從 CfConnectSyncRoot 傳回的連接密鑰，現在用來中斷同步根的連線。

傳回值

如果函式成功，則會傳 S_OK回 。 否則，它會傳回 HRESULT 錯誤碼。

備註

這會移除先前使用 CfConnectSyncRoot 建立之平臺的通道。

同步提供者仍然可以在 CfDisconnectSyncRoot 呼叫期間接收回呼，而且提供者可以選擇呼叫是否需要失敗或服務。 任一選擇都不會造成同步提供者中斷。

呼叫 CfDisconnectSyncRoot 之後，同步提供者將不再收到回呼，而平臺將會失敗任何相依於上述回呼的作業。

同步提供者應該具有 WRITE_DATA 或 WRITE_DAC 同步根目錄的存取權，以中斷連線，或呼叫 CfDisconnectSyncRoot 將會失敗，而 HRESULT (ERROR_CLOUD_FILE_ACCESS_DENIED) 。 此外，如果先前尚未連線同步根目錄，呼叫將會失敗，且參數無效。 此 API 可以呼叫為正常關閉同步提供者的一部分。 不過，如果同步提供者進程選擇終止而不呼叫此 API，或意外損毀，平臺將會偵測到此情況並執行必要的清除。

規格需求

另請參閱

CfConnectSyncRoot