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

추가 정보

SetConvertStg