다음을 통해 공유


OleRegGetUserType 함수(ole2.h)

레지스트리에서 지정된 클래스의 사용자 유형을 가져옵니다.

사용자 지정 DLL 개체 애플리케이션 개발자는 이 함수를 사용하여 OLE 기본 처리기의 동작을 에뮬레이트합니다.

구문

HRESULT OleRegGetUserType(
  [in]  REFCLSID clsid,
  [in]  DWORD    dwFormOfType,
  [out] LPOLESTR *pszUserType
);

매개 변수

[in] clsid

사용자 유형을 요청할 클래스의 CLSID입니다.

[in] dwFormOfType

사용자가 표시할 수 있는 문자열의 형식입니다. 가능한 값은 USERCLASSTYPE 열거형에서 가져옵니다.

[out] pszUserType

사용자 형식을 수신하는 문자열에 대한 포인터입니다.

반환 값

이 함수는 E_OUTOFMEMORY 표준 반환 값과 다음 값을 반환할 수 있습니다.

반환 코드 Description
S_OK
사용자 유형이 성공적으로 반환되었습니다.
REGDB_E_CLASSNOTREG
클래스 개체에 대해 등록된 CLSID가 없습니다.
REGDB_E_READREGDB
레지스트리에서 읽는 동안 오류가 발생했습니다.
OLE_E_REGDB_KEY
ProgID = MainUserTypeNameCLSID = MainUserTypeName 키가 레지스트리에서 누락되었습니다.

설명

개체 애플리케이션은 두 가지 방법 중 하나로 OLE에 지정된 클래스의 사용자 형식 이름을 가져올 것을 요청할 수 있습니다. 한 가지 방법은 OleRegGetUserType을 호출하는 것입니다. 다른 하나는 IOleObject::GetUserType에 대한 기본 개체 처리기의 호출에 대한 응답으로 OLE_S_USEREG 반환하는 것입니다. OLE_S_USEREG 기본 처리기에 OleRegGetUserType을 호출하도록 지시합니다. DLL 개체 애플리케이션은 OLE_S_USEREG 반환할 수 없으므로 개체 처리기에 작업을 위임하는 대신 OleRegGetUserType을 호출해야 합니다.

OleRegGetUserType 함수 및 해당 형제 함수인 OleRegGetMiscStatus, OleRegEnumFormatEtcOleRegEnumVerbs는 사용자 지정 DLL 개체 애플리케이션 개발자가 레지스트리에서 개체에 대한 정보를 가져오는 OLE의 기본 개체 처리기의 동작을 에뮬레이트하는 방법을 제공합니다. 이러한 함수를 사용하면 직접 작성하는 상당한 작업과 레지스트리에서 직접 작업하는 데 내재된 문제를 방지할 수 있습니다. 또한 이러한 함수를 직접 코딩하지 않고도 이러한 함수의 향후 향상된 기능과 최적화를 얻을 수 있습니다.

요구 사항

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

추가 정보

IOleObject::GetUserType

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetMiscStatus