建立 IFilterKeyMap 物件並使用序列化資料將它初始化。
HRESULT DeserializeFilterKeyMap(
ISyncFilterDeserializer * pISyncFilterDeserializer,
const BYTE * pbFilterKeyMap,
DWORD dwCbFilterKeyMap,
IFilterKeyMap ** ppFilterKeyMap);
參數
- pISyncFilterDeserializer
[in] 用來還原序列化包含在已序列化篩選機碼對應資料中之自訂篩選的物件。
- pbFilterKeyMap
[in, size_is(dwCbFilterKeyMap)] 序列化的篩選機碼對應資料。
- dwCbFilterKeyMap
[in] pbFilterKeyMap 中的位元組數目。
- ppFilterKeyMap
[out] 傳回篩選機碼對應物件，這個物件是使用 pbFilterKeyMap 中包含的序列資料初始化。
傳回值
S_OK。
E_OUTOFMEMORY。
E_POINTER。
如果在序列化期間發生問題，則為 SYNC_E_DESERIALIZATION。當包含在序列化資料中的序列化版本小於 SYNC_SERIALIZATION_VERSION_V3 時，也會傳回這個錯誤。
如果此物件未透過呼叫 IProviderSyncServices::Initialize 來初始化，則為 SYNC_E_INVALID_OPERATION。
備註
篩選機碼對應是由提供者所使用，這個提供者代表追蹤篩選的複寫。篩選機碼對應會將 DWORD 篩選機碼對應至 ISyncFilter 物件。
為了還原序列化包含在已序列化資料中的自訂篩選，這個方法會針對已序列化資料中的每個篩選呼叫 ISyncFilterDeserializer::DeserializeSyncFilter 一次。