Share via

OleLoadPicture 함수(olectl.h)

  • 아티클

새 그림 개체를 만들고 스트림의 내용에서 초기화합니다. 이는 NULL을 첫 번째 매개 변수로 사용하여 OleCreatePictureIndirect를 호출한 다음 IPersistStream::Load를 호출하는 것과 같습니다.

구문

WINOLECTLAPI OleLoadPicture(
  [in]  LPSTREAM lpstream,
  [in]  LONG     lSize,
  [in]  BOOL     fRunmode,
  [in]  REFIID   riid,
  [out] LPVOID   *lplpvObj
);

매개 변수

[in] lpstream

그림의 데이터가 포함된 스트림에 대한 포인터입니다.

[in] lSize

스트림에서 읽어야 하는 바이트 수 또는 전체 스트림을 읽어야 하는 경우 0입니다.

[in] fRunmode

KeepOriginalFormat 속성의 초기 값과 반대입니다. TRUE이면 KeepOriginalFormat이 FALSE로 설정되고 그 반대의 경우도 마찬가지입니다.

[in] riid

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

[out] lplpvObj

riid에서 요청된 인터페이스 포인터를 수신하는 포인터 변수의 주소입니다. 반환에 성공하면 *ppvObj 는 모니커로 식별된 개체의 스토리지에 요청된 인터페이스 포인터를 포함합니다. *ppvObj 가 NULL이 아닌 경우 이 함수는 인터페이스에서 IUnknown::AddRef 를 호출합니다. IUnknown::Release를 호출하는 것은 호출자의 책임입니다. 오류가 발생하면 *ppvObj 가 NULL로 설정됩니다.

반환 값

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

반환 코드 설명
E_NOINTERFACE
 개체는 지정된 인터페이스를 지원하지 않습니다.
E_POINTER
 스트림이 잘못되었습니다. 예를 들어 NULL일 수 있습니다.

설명

스트림은 BMP(비트맵), WMF(메타파일) 또는 ICO(아이콘) 형식이어야 합니다. OleLoadPicture를 사용하여 만든 그림 개체에는 항상 내부 리소스의 소유권이 있습니다(fOwn==TRUE는 암시됨).

요구 사항

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

추가 정보

OleCreatePictureIndirect

PICTDESC