OleCreatePictureIndirect 함수(olectl.h)

  • 아티클

PICTDESC 구조체에 따라 초기화된 새 그림 개체를 만듭니다.

구문

WINOLECTLAPI OleCreatePictureIndirect(
  [in]  LPPICTDESC lpPictDesc,
  [in]  REFIID     riid,
  [in]  BOOL       fOwn,
  [out] LPVOID     *lplpvObj
);

매개 변수

[in] lpPictDesc

그림의 초기 상태를 포함하는 호출자가 할당한 구조체에 대한 포인터입니다. IPersistStream::Load를 통해 그림을 초기화해야 하는 경우 지정한 구조체를 NULL로 설정하여 초기화되지 않은 개체를 만들 수 있습니다.

[in] riid

lplpvObj에서 반환할 인터페이스 포인터의 형식을 설명하는 인터페이스의 식별자에 대한 참조입니다.

[in] fOwn

TRUE이면 개체가 제거되면 그림 개체가 해당 그림을 삭제합니다. FALSE이면 호출자가 그림을 삭제할 책임이 있습니다.

[out] lplpvObj

riid에서 요청된 인터페이스 포인터를 수신하는 포인터 변수의 주소입니다. 반환이 성공하면 이 매개 변수는 새로 만든 개체에 대해 요청된 인터페이스 포인터를 포함합니다. 호출에 성공하면 호출자는 새 개체가 더 이상 필요하지 않을 때 이 인터페이스 포인터를 통해 Release 를 호출합니다. 호출이 실패하면 값이 NULL로 설정됩니다.

반환 값

이 함수는 성공에 대한 S_OK 반환합니다. 다른 가능한 값은 다음과 같습니다.

반환 코드 설명
E_NOINTERFACE
 개체는 riid에 지정된 인터페이스를 지원하지 않습니다.
E_POINTER
 pPictDesc 또는 lplpvObj의 주소가 잘못되었습니다. 예를 들어 NULL일 수 있습니다.

설명

fOwn 매개 변수는 그림이 포함된 그림의 GDI 그림 핸들을 소유할지 여부를 나타내므로 개체 자체가 제거될 때 그림 개체가 그림을 삭제합니다. 함수는 riid 매개 변수의 호출자가 지정한 새 그림 개체에 대한 인터페이스 포인터를 반환합니다. QueryInterface는 이 호출에 기본으로 사용됩니다. 호출자는 반환된 인터페이스 포인터를 통해 Release 를 호출합니다.

요구 사항

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

추가 정보

OleLoadPicture

PICTDESC