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

ITfContextOwnerServices::Serialize 메서드는 텍스트 범위에서 속성을 가져오고 속성 데이터를 스트림 개체에 씁니다. 이렇게 하면 애플리케이션에서 속성 데이터를 저장할 수 있습니다(예: 파일에 데이터를 쓸 때).

구문

HRESULT Serialize(
  [in]  ITfProperty                       *pProp,
  [in]  ITfRange                          *pRange,
  [out] TF_PERSISTENT_PROPERTY_HEADER_ACP *pHdr,
  [in]  IStream                           *pStream
);

매개 변수

[in] pProp

직렬화할 속성을 식별하는 ITfProperty 인터페이스에 대한 포인터입니다.

[in] pRange

속성을 가져오는 범위를 식별하는 ITfRange 인터페이스에 대한 포인터입니다.

[out] pHdr

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

[in] pStream

TSF 관리자가 속성 데이터를 쓸 IStream 개체에 대한 포인터입니다.

반환 값

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

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
S_FALSE	속성을 serialize할 수 없습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.

설명

pHdr에 배치된 속성 헤더 데이터는 모든 속성에 공통되며 pStream에 기록된 데이터로 보존되어야 합니다. 속성 데이터를 복원하려면 이 동일한 데이터 쌍을 ITfContextOwnerServices::Unserialize 에 전달해야 합니다.

애플리케이션은 다음 단계를 수행하여 전체 문서에 대한 모든 속성을 저장할 수 있습니다.

• ITfContext::EnumProperties를 사용하여 모든 속성을 열거합니다.
• 각 속성 내에서 ITfReadOnlyProperty::EnumRanges를 사용하여 범위를 열거합니다.
• 현재 속성 및 범위를 이 메서드에 전달합니다.
• pHdr에 배치된 데이터를 파일에 씁니다.
• pStream에 추가된 데이터를 파일에 씁니다.

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

요구 사항

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

추가 정보

ITfContextOwnerServices

ITfProperty

ITfRange

TF_PERSISTENT_PROPERTY_HEADER_ACP