由派生类重写时,将筛选器序列化为一个字节数组。
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 首次调用此方法时,为 pbSyncFilter 指定 NULL,为 pcbSyncFilter 指定 0。在这种情况下,实现必须返回 pcbSyncFilter 中项 ID 的正确大小,并返回错误代码 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。
实现此方法时,开发人员还必须实现 ISyncFilterDeserializer::DeserializeSyncFilter 以反序列化序列化的数据。
如果不需要序列化筛选器,则此方法可返回 E_NOTIMPL。