ITfContextOwnerServices::Unserialize 메서드(msctf.h)

속성 개체에 이전에 직렬화된 속성 데이터를 적용합니다.

구문

HRESULT Unserialize(
  [in] ITfProperty                             *pProp,
  [in] const TF_PERSISTENT_PROPERTY_HEADER_ACP *pHdr,
  [in] IStream                                 *pStream,
  [in] ITfPersistentPropertyLoaderACP          *pLoader
);

매개 변수

[in] pProp

속성 데이터를 수신하는 ITfProperty 개체에 대한 포인터입니다.

[in] pHdr

속성의 헤더 데이터를 포함하는 TF_PERSISTENT_PROPERTY_HEADER_ACP 구조체에 대한 포인터입니다.

[in] pStream

속성 데이터를 포함하는 IStream 개체에 대한 포인터입니다. pLoader가 NULL이 아닌 경우 이 매개 변수는 NULL일 수 있습니다. pLoader가 NULL이 아닌 경우 이 매개 변수는 무시됩니다.

[in] pLoader

TSF 관리자가 속성 데이터를 가져오는 데 사용하는 ITfPersistentPropertyLoaderACP 개체에 대한 포인터입니다. pStream이 NULL이 아닌 경우 이 매개 변수는 NULL일 수 있습니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
TF_S_ASYNC	속성 데이터는 비동기적으로 가져옵니다.
TF_E_SYNCHRONOUS	동기 읽기 전용 잠금을 가져올 수 없습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.

설명

pStream이 pLoader가 아닌 지정된 경우 이 메서드를 호출하는 동안 pStream에서 속성 데이터를 읽습니다. pStream이 아닌 pLoader를 지정하면 속성 데이터가 pLoader에서 비동기적으로 읽습니다. pStream을 사용하면 속성 데이터가 큰 경우 긴 지연이 발생할 수 있습니다.

이 메서드를 호출할 때 애플리케이션은 동기 읽기 전용 잠금을 부여할 수 있어야 합니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	msctf.h
DLL	Msctf.dll
재배포 가능 파일	Windows 2000 Professional의 TSF 1.0

참고 항목

ITfContextOwnerServices 인터페이스, ITfContextOwnerServices::Serialize, ITfProperty 인터페이스, ITfPersistentPropertyLoaderACP 인터페이스, TF_PERSISTENT_PROPERTY_HEADER_ACP 구조체