共用方式為

ISyncFilter::Serialize

  • 發行項

由衍生類別所覆寫時，會將篩選序列化為位元組的陣列。

HRESULT Serialize(
  BYTE * pbSyncFilter,
  DWORD * pcbSyncFilter);

參數

  • pbSyncFilter
    [in, out, unique, size_is(*pcbSyncFilter)] 接收篩選資料的位元組陣列。
  • pcbSyncFilter
    [in, out] 指定 pbSyncFilter 中的位元組數目。當 pbSyncFilter 太小時傳回 pbSyncFilter 所需的位元組數目，或傳回在資料寫入時寫入到 pbSyncFilter 的位元組數目。

傳回值

  • S_OK。

  • 當 pbChangeBatch 太小時，為 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在這種情況下，所需的位元組數目是儲存在 pcbChangeBatch 中。

  • 提供者決定的錯誤碼。

備註

Sync Framework 第一次呼叫此方法時，它會指定 NULL 給 pbSyncFilter，並指定 0 給 pcbSyncFilter。在此情況下，實作必須在 pcbSyncFilter 中傳回項目識別碼的正確大小，以及 HRESULT_FROM_WIN32(ERROR_MORE_DATA) 的錯誤碼。

實作這個方法時，開發人員也必須實作 ISyncFilterDeserializer::DeserializeSyncFilter 才能還原序列化已序列化的資料。

如果不需要序列化篩選，這個方法可能會傳回 E_NOTIMPL。

請參閱

參考

ISyncFilter 介面