OleCreate 함수(ole.h)

CLSID로 식별되는 포함된 개체를 만듭니다. 일반적으로 최종 사용자가 새 개체를 삽입할 수 있는 메뉴 항목을 구현하는 데 사용합니다.

구문

OLESTATUS OleCreate(
  LPCSTR        unnamedParam1,
  LPOLECLIENT   unnamedParam2,
  LPCSTR        unnamedParam3,
  LHCLIENTDOC   unnamedParam4,
  LPCSTR        unnamedParam5,
  LPOLEOBJECT   *unnamedParam6,
  OLEOPT_RENDER unnamedParam7,
  OLECLIPFORMAT unnamedParam8
);

매개 변수

unnamedParam1

TBD

unnamedParam2

TBD

unnamedParam3

TBD

unnamedParam4

TBD

unnamedParam5

TBD

unnamedParam6

TBD

unnamedParam7

TBD

unnamedParam8

TBD

반환 값

이 함수는 성공에 대한 S_OK 반환하고 표준 반환 값 E_OUTOFMEMORY 지원합니다.

반환 코드	설명
E_OUTOFMEMORY	작업에 대한 메모리가 부족합니다.

설명

OleCreate 함수는 새 포함된 개체를 만들고 일반적으로 새 개체 삽입 메뉴 항목을 구현하기 위해 호출됩니다. OleCreate가 반환되면 renderopt가 OLERENDER_DRAW 또는 OLERENDER_FORMAT 로드되지 않는 한 만든 개체는 비어 있습니다(데이터가 포함되지 않음). 컨테이너는 일반적으로 OleRun 함수 또는 IOleObject::D oVerb 을 호출하여 초기 편집을 위해 개체를 표시합니다.

rclsid 매개 변수는 요청된 개체의 CLSID를 지정합니다. 등록된 개체의 CLSID는 시스템 레지스트리에 저장됩니다. 애플리케이션 사용자가 개체 삽입을 선택하면 선택 상자를 사용하면 레지스트리에 있는 개체에서 원하는 개체 유형을 선택할 수 있습니다. OleCreate를 사용하여 개체 삽입 메뉴 항목을 구현하면 선택한 항목과 연결된 CLSID가 OleCreate의 rclsid 매개 변수에 할당됩니다.

riid 매개 변수는 클라이언트가 새 개체와 통신하는 데 사용할 인터페이스를 지정합니다. 반환이 성공하면 ppvObject 매개 변수는 요청된 인터페이스에 대한 포인터를 보유합니다.

만든 개체의 캐시에는 컨테이너가 열릴 때 포함된 개체를 표시할 수 있는 정보가 포함되어 있습니다. 캐시해야 하는 내용에 대한 정보는 renderopt 및 pFormatetc 값에 전달됩니다. OleCreate가 반환되면 생성된 개체의 캐시가 반드시 채워지지는 않습니다. 대신 개체가 실행 중 상태가 될 때 캐시가 채워집니다. 호출자는 OleCreate를 반환한 후 개체가 실행되기 전에 IOleCache::Cache를 호출하여 추가 캐시 컨트롤을 추가할 수 있습니다. renderopt가 OLERENDER_DRAW 또는 OLERENDER_FORMAT 경우 OleCreate 를 사용하려면 개체가 IOleCache 인터페이스를 지원해야 합니다. renderopt의 다른 값에는 이러한 요구 사항이 없습니다.

pClientSite가 NULL이 아닌 경우 OleCreate는 pClientSite 포인터를 통해 IOleObject::SetClientSite를 호출합니다. IOleClientSite 는 개체가 컨테이너에서 서비스를 요청하는 기본 인터페이스입니다. pClientSite가 NULL인 경우 작업을 시도하기 전에 IOleObject::SetClientSite를 특정 호출해야 합니다.

요구 사항

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

추가 정보

Formatetc

IOleClientSite

IOleObject

OLERENDER