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 |
|---|---|
|
메서드를 성공적으로 수행했습니다. |
|
속성을 serialize할 수 없습니다. |
|
지정되지 않은 오류가 발생했습니다. |
설명
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 |