OleGetAutoConvert 함수(ole2.h)

  • 아티클

지정된 CLSID의 개체에 대해 레지스트리가 다른 CLSID로 자동으로 변환되도록 설정되었는지 여부를 확인하고, 이 경우 새 CLSID를 검색합니다.

구문

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

매개 변수

[in] clsidOld

개체의 CLSID입니다.

[out] pClsidNew

새 CLSID(있는 경우)를 수신할 변수에 대한 포인터입니다. 레지스트리에서 clsidOld에 대한 자동 변환이 설정되지 않은 경우 clsidOld가 반환됩니다. pClsidNew 매개 변수는 NULL이 되지 않습니다.

반환 값

이 함수는 다음 값뿐만 아니라 E_INVALIDARG, E_OUTOFMEMORY 및 E_UNEXPECTED 표준 반환 값을 반환할 수 있습니다.

반환 코드 Description
S_OK
 pclsidNew 매개 변수를 통해 값이 성공적으로 반환되었습니다.
REGDB_E_CLASSNOTREG
 CLSID가 레지스트리에 제대로 등록되지 않았습니다.
REGDB_E_READREGDB
 레지스트리에서 읽는 동안 오류가 발생했습니다.
REGDB_E_KEYMISSING
 자동 변환이 활성 상태가 아니거나 clsidOld 매개 변수에 대한 레지스트리 항목이 없습니다.

설명

OleGetAutoConvert 는 지정된 개체에 대한 레지스트리의 AutoConvertTo 항목을 반환합니다. AutoConvertTo 하위 키는 지정된 CLSID의 개체를 새 CLSID로 자동으로 변환할지 여부를 지정합니다. 일반적으로 이전 버전의 애플리케이션에서 만든 파일을 현재 버전으로 변환하는 데 사용됩니다. AutoConvertTo 항목이 없으면 이 함수는 clsidOld 값을 반환합니다.

OleDoAutoConvert 함수는 OleGetAutoConvert를 호출하여 지정된 개체를 변환할지 여부를 확인합니다. 개체 변환을 지원하는 컨테이너 애플리케이션은 개체를 로드할 때마다 OleDoAutoConvert 를 호출해야 합니다. 컨테이너가 OleLoad 도우미 함수를 사용하는 경우 OleLoad가 내부적으로 호출하기 때문에 OleDoAutoConvert를 명시적으로 호출할 필요가 없습니다.

지정된 클래스의 자동 변환을 설정하려면 OleSetAutoConvert 함수를 호출할 수 있습니다(일반적으로 애플리케이션 설치의 설치 프로그램에서). 이 함수는 AutoConvertTo 하위 키를 사용하여 개체의 클래스에 태그를 지정하여 다른 개체 클래스로 자동 변환합니다. CLSID 키의 하위 키입니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 ole2.h
라이브러리 Ole32.lib
DLL Ole32.dll
API 세트 ext-ms-win-com-ole32-l1-1-0(Windows 8 도입)

추가 정보

AutoConvertTo

OleDoAutoConvert

OleSetAutoConvert