CoTreatAsClass 함수(objbase.h)
한 클래스의 개체가 다른 클래스의 개체로 처리되는 에뮬레이션을 설정하거나 제거합니다.
구문
HRESULT CoTreatAsClass(
[in] REFCLSID clsidOld,
[in] REFCLSID clsidNew
);
매개 변수
[in] clsidOld
에뮬레이트할 개체의 CLSID입니다.
[in] clsidNew
원래 개체를 에뮬레이트해야 하는 개체의 CLSID입니다. 이렇게 하면 clsidOld에 대한 기존 에뮬레이션이 대체됩니다. 이 매개 변수는 CLSID_NULL 수 있습니다. 이 경우 clsidOld 에 대한 기존 에뮬레이션이 제거됩니다.
반환 값
이 함수는 E_INVALIDARG 표준 반환 값과 다음 값을 반환할 수 있습니다.
| 반환 코드 | Description |
|---|---|
|
에뮬레이션이 성공적으로 설정되거나 제거되었습니다. |
|
clsidOld 매개 변수가 등록 데이터베이스에 제대로 등록되지 않았습니다. |
|
등록 데이터베이스에서 읽는 동안 오류가 발생했습니다. |
|
등록 데이터베이스에 쓰는 동안 오류가 발생했습니다. |
설명
이 함수는 지정된 개체에 대한 레지스트리의 TreatAs 항목을 설정하여 다른 애플리케이션에서 개체를 에뮬레이트할 수 있도록 합니다. 에뮬레이션을 사용하면 애플리케이션이 개체의 원래 형식을 유지하면서 다른 형식의 개체를 열고 편집할 수 있습니다. 이 항목이 설정되면 CoGetClassObject 와 같은 함수가 개체의 원래 CLSID(clsidOld)를 지정할 때마다 새 CLSID(clsidNew)로 투명하게 전달되어 TreatAs CLSID와 연결된 애플리케이션을 시작합니다. 개체가 저장되면 네이티브 형식으로 저장할 수 있으므로 원래 형식에서 지원되지 않는 편집 내용이 손실될 수 있습니다.
애플리케이션이 에뮬레이션을 지원하는 경우 다음과 같은 상황에서 CoTreatAsClass 를 호출합니다.
- 지정된 개체가 다른 클래스의 개체로 처리되는 최종 사용자 요청(변환 대화 상자를 통해)에 대한 응답입니다(원래 형식 정보를 유지하면서 한 애플리케이션에서 만든 개체를 다른 애플리케이션에서 실행).
- 설치 프로그램에서 한 클래스의 개체가 다른 클래스의 개체로 처리되도록 등록합니다.
설치 프로그램에서 CoTreatAsClass 를 사용하는 예제는 업데이트된 버전의 애플리케이션에 있습니다. 애플리케이션이 업데이트되면 이전 버전으로 만든 개체를 활성화하고 이전 형식 정보를 유지하면서 새 버전의 개체로 처리할 수 있습니다. 이렇게 하면 사용자가 저장할 때 변환하거나 이전 형식으로 저장할 수 있는 옵션을 제공할 수 있으며, 이전 버전에서는 사용할 수 없는 형식 정보가 손실될 수 있습니다.
에뮬레이션 설정의 한 가지 결과는 기본 처리기의 IOleObject::EnumVerbs 메서드 구현에서와 같이 동사를 열거할 때 clsidOld 대신 clsidNew의 동사를 열거한다는 것입니다.
애플리케이션을 설치할 때 기존 에뮬레이션 정보가 제거되도록 하려면 설치 프로그램에서 CoTreatAsClass를 호출하고 clsidNew 매개 변수를 CLSID_NULL 설정하여 설치하는 클래스에 대한 기존 에뮬레이션을 제거해야 합니다.
레지스트리의 AutoTreatAs 키에 할당된 CLSID가 없는 경우 clsidNew 및 clsidOld 를 동일한 값으로 설정하면 TreatAs 항목이 제거되므로 에뮬레이션이 없습니다. AutoTreatAs 키에 할당된 CLSID가 있는 경우 해당 CLSID는 TreatAs 키에 할당됩니다.
CoTreatAsClass 는 clsidNew에 대한 적절한 레지스트리 항목이 현재 존재하는지 여부를 확인하지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | objbase.h |
| 라이브러리 | Ole32.lib |
| DLL | Ole32.dll |