共用方式為


IKnowledgeSyncProvider::GetSyncBatchParameters

取得變更批次中要包含的要求項目變更數目,以及此同步處理範圍的目前知識。

HRESULT GetSyncBatchParameters(
  ISyncKnowledge ** ppSyncKnowledge,
  DWORD * pdwRequestedBatchSize);

參數

  • ppSyncKnowledge
    [out] 傳回同步處理範圍的目前知識,或傳回新建立的知識物件 (如果沒有任何目前知識的話)。
  • pdwRequestedBatchSize
    [out] 傳回此來源提供者所傳回變更批次中要包含的要求項目變更數目。

傳回值

  • S_OK

  • 提供者決定的錯誤碼

備註

一般來說,Sync Framework 會在呼叫 IKnowledgeSyncProvider::BeginSession 之後到呼叫 IKnowledgeSyncProvider::EndSession 之前,呼叫此方法。但是 IEndpointState::LoadFromProvider 方法會在呼叫 BeginSession 之前呼叫此方法。

實作者注意事項

如果此複寫沒有任何知識,就使用 IProviderSyncServices::CreateSyncKnowledge 建立新的知識物件。

在這個方法中傳回此知識物件前,必須先在知識物件上呼叫 ISyncKnowledge::SetLocalTickCount,將滴答計數設定為此複寫的目前滴答計數。

在 pdwRequestedBatchSize 中傳送的項目變更數目只是要求的數目。來源提供者可以忽略這項值,並且傳回任何大小的批次。

請參閱

參考

IKnowledgeSyncProvider 介面