IProviderCustomFilteredSyncServices::DeserializeFilterKeyMap
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를 한 번씩 호출합니다.