CoGetTreatAsClass 함수(combaseapi.h)

  • 아티클

지정된 개체를 에뮬레이트할 수 있는 개체의 CLSID를 반환합니다.

구문

HRESULT CoGetTreatAsClass(
  [in]  REFCLSID clsidOld,
  [out] LPCLSID  pClsidNew
);

매개 변수

[in] clsidOld

다른 CLSID를 사용하여 개체를 에뮬레이트(로 처리)할 수 있는 개체의 CLSID입니다.

[out] pClsidNew

clsidOld 개체를 에뮬레이트할 수 있는 CLSID가 검색되는 위치에 대한 포인터입니다. 이 매개 변수는 NULL일 수 없습니다. clsidOld 개체에 대한 에뮬레이션 정보가 없으면 clsidOld 매개 변수가 제공됩니다.

반환 값

이 함수는 CLSIDFromString 함수에서 반환하는 오류 값뿐만 아니라 다음 값을 반환할 수 있습니다.

반환 코드 Description
S_OK
 새 CLSID가 성공적으로 반환되었습니다.
S_FALSE
 clsidOld 매개 변수에 대한 에뮬레이션 정보가 없으므로 pClsidNew 매개 변수가 clsidOld로 설정됩니다.
REGDB_E_READREGDB
레지스트리를 읽는 동안 오류가 발생했습니다.

설명

CoGetTreatAsClass 는 지정된 개체에 대한 레지스트리의 TreatAs 항목을 반환합니다. TreatAs 항목(설정된 경우)은 해당 개체를 에뮬레이트할 수 있는 등록된 개체(애플리케이션)의 CLSID입니다. TreatAs 항목은 CoTreatAsClass 함수에 대한 호출을 통해 설정됩니다. 에뮬레이션을 사용하면 애플리케이션이 개체의 원래 형식을 유지하면서 다른 형식의 개체를 열고 편집할 수 있습니다. 원래 CLSID의 개체가 활성화되고 두 번째 CLSID의 개체로 처리됩니다. 개체가 저장되면 원래 형식에서 지원되지 않는 편집 내용이 손실됩니다. 지정된 개체에 대한 TreatAs 항목이 없으면 이 함수는 원래 개체(clsidOld)의 CLSID를 반환합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 combaseapi.h(Objbase.h 포함)
라이브러리 Ole32.lib
DLL Ole32.dll

추가 정보

CoTreatAsClass