GetConvertStg 함수(coml2api.h)
GetConvertStg 함수는 지정된 스토리지 개체에 대한 변환 비트의 현재 값을 반환합니다.
구문
HRESULT GetConvertStg(
[in] LPSTORAGE pStg
);
매개 변수
[in] pStg
변환 비트를 검색할 스토리지 개체에 대한 IStorage 포인터입니다.
반환 값
IStorage::OpenStream, IStorage::OpenStorage 및 ISequentialStream::읽기 스토리지 및 스트림 액세스 오류입니다.
설명
GetConvertStg 함수는 개체를 한 형식에서 다른 형식으로 변환하는 것을 지원하는 개체 서버에서 호출됩니다. 서버는 이전 CLSID(클래스 식별자) 형식을 사용하여 스토리지 개체를 읽고 개체의 변환을 지원하기 위해 새 CLSID 형식을 사용하여 개체를 작성할 수 있어야 합니다. 예를 들어 한 애플리케이션에서 만든 스프레드시트를 다른 애플리케이션에서 사용하는 형식으로 변환할 수 있습니다.
변환 비트는 SetConvertStg 함수를 호출하여 설정합니다. 컨테이너 애플리케이션은 최종 사용자의 요청에 따라 이 함수를 호출하거나 새 버전의 애플리케이션을 설치할 때 설치 프로그램에서 이 함수를 호출할 수 있습니다. 최종 사용자가 변환 대상 대화 상자를 통해 개체 변환을 요청합니다. 개체가 변환되면 새 CLSID가 개체에 영구적으로 할당되므로 이후에 개체가 새 CLSID와 연결됩니다.
그런 다음 개체가 활성화되면 해당 서버는 GetConvertStg 함수를 호출하여 스토리지 개체에서 변환 비트의 값을 검색합니다. 비트가 설정된 경우 개체의 CLSID가 변경되었으며 서버는 이전 형식을 읽고 스토리지 개체에 대한 새 형식을 작성해야 합니다.
비트 값을 검색한 후 개체 애플리케이션은 fConvert 매개 변수가 FALSE로 설정된 SetConvertStg 함수를 호출하여 변환 비트를 지워야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | coml2api.h(Ole2.h 포함) |
| 라이브러리 | Ole32.lib |
| DLL | Ole32.dll |