SetConvertStg 함수(ole2.h)
SetConvertStg 함수는 스토리지 개체의 변환 비트를 설정하여 개체가 열릴 때 새 클래스로 변환되어야 함을 나타냅니다. GetConvertStg 함수를 호출하여 설정을 검색할 수 있습니다.
구문
HRESULT SetConvertStg(
LPSTORAGE pStg,
BOOL fConvert
);
매개 변수
pStg
변환 비트를 설정할 스토리지 개체에 대한 IStorage 포인터입니다.
fConvert
TRUE이면 개체를 열 때 변환할 개체를 나타내도록 개체의 변환 비트를 설정합니다. FALSE이면 변환 비트를 지웁니다.
반환 값
가능한 스토리지 및 스트림 액세스 오류는 IStorage::CreateStream, IStorage::OpenStream, ISequentialStream::Read 및 ISequentialStream::Write 메서드를 참조하세요.
설명
SetConvertStg 함수는 포함된 개체에서 변환 비트의 상태 결정합니다. 개체를 한 클래스에서 다른 클래스로 변환하는 과정에서 컨테이너 애플리케이션과 서버 모두에서 호출됩니다. 사용자가 개체를 변환할 개체를 변환할 대화 상자(컨테이너가 OleUIConvert 함수를 호출하여 생성)를 통해 지정하는 경우 컨테이너는 다음 단계를 수행해야 합니다.
- 개체가 현재 로드된 경우 언로드합니다.
- WriteClassStg를 호출하여 새 CLSID를 개체 스토리지에 씁니다.
- WriteFmtUserTypeStg를 호출하여 새 사용자 유형 이름과 기존 기본 형식을 스토리지에 씁니다.
- fConvert 매개 변수가 TRUE로 설정된 SetConvertStg를 호출하여 다음에 로드될 때 개체가 새 클래스로 변환되도록 태그가 지정되었음을 나타냅니다.
- 개체가 로드되기 직전에 OleDoAutoConvert 를 호출하여 내부적으로 호출하는 OleLoad를 호출하지 않는 한 필요한 개체 변환을 처리합니다.
- GetConvertStg 함수를 호출하여 변환 비트의 값을 검색합니다.
- 비트가 설정된 경우 서버는 새 CLSID와 연결된 형식에 따라 개체에서 데이터를 읽습니다.
- 개체 자체를 저장하라는 메시지가 표시되면 개체는 개체의 일반 네이티브 형식과 사용자 형식을 사용하여 WriteFmtUserTypeStg 함수를 호출해야 합니다.
- 그런 다음 개체는 fConvert 매개 변수가 FALSE로 설정된 SetConvertStg를 호출하여 개체의 변환 비트를 다시 설정해야 합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | ole2.h |
라이브러리 | Ole32.lib |
DLL | Ole32.dll |