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 반환합니다. 다른 가능한 값은 다음과 같습니다.
반환 코드 | 설명 |
---|---|
|
개체는 riid에 지정된 인터페이스를 지원하지 않습니다. |
|
pPictDesc 또는 lplpvObj의 주소가 잘못되었습니다. 예를 들어 NULL일 수 있습니다. |
설명
fOwn 매개 변수는 그림이 포함된 그림의 GDI 그림 핸들을 소유할지 여부를 나타내므로 개체 자체가 제거될 때 그림 개체가 그림을 삭제합니다. 함수는 riid 매개 변수의 호출자가 지정한 새 그림 개체에 대한 인터페이스 포인터를 반환합니다. QueryInterface는 이 호출에 기본으로 사용됩니다. 호출자는 반환된 인터페이스 포인터를 통해 Release 를 호출합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | olectl.h |
라이브러리 | OleAut32.lib |
DLL | OleAut32.dll |