OleCreateDefaultHandler 함수(ole2.h)

기본 포함 처리기의 새 instance 만듭니다. 이 instance 초기화되므로 포함된 개체가 실행 중 상태가 될 때 로컬 서버를 만듭니다.

구문

HRESULT OleCreateDefaultHandler(
  [in]  REFCLSID  clsid,
  [in]  LPUNKNOWN pUnkOuter,
  [in]  REFIID    riid,
  [out] LPVOID    *lplpObj
);

매개 변수

[in] clsid

포함된 개체가 실행 중 상태가 될 때 로드할 OLE 서버를 식별하는 CLSID입니다.

[in] pUnkOuter

처리기를 집계할 경우 제어하는 IUnknown 인터페이스에 대한 포인터입니다. 집계되지 않을 경우 NULL 입니다.

[in] riid

일반적으로 호출자가 처리기와 통신하는 IID_IOleObject 인터페이스의 식별자에 대한 참조입니다.

[out] lplpObj

riid에서 요청된 인터페이스 포인터를 수신하는 포인터 변수의 주소입니다. 반환이 성공하면 *ppvObj 는 새로 만든 처리기에 요청된 인터페이스 포인터를 포함합니다.

반환 값

이 함수는 성공에 대해 NOERROR를 반환하고 E_OUTOFMEMORY 표준 반환 값을 지원합니다.

설명

OleCreateDefaultHandler는 기본 포함 처리기의 새 instance 만들어 초기화되어 포함된 개체가 실행 중 상태가 될 때 clsid 매개 변수로 식별되는 로컬 서버를 만듭니다. 처리기를 작성하고 기본 처리기의 서비스를 사용하려는 경우 OleCreateDefaultHandler를 호출합니다. 또한 OLE는 개체 만들기 호출에 지정된 CLSID가 등록되지 않은 경우에도 내부적으로 호출합니다.

지정된 클래스에 특수 처리기가 없는 경우 OleCreateDefaultHandler 호출은 클래스 컨텍스트 매개 변수가 CLSCTX_INPROC_HANDLER 값을 할당한 CoCreateInstance 함수 호출과 동일한 결과를 생성합니다.

요구 사항

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

추가 정보

CLSCTX

CoCreateInstance