OleLoadPicturePath 함수(olectl.h)

  • 아티클

새 그림 개체를 만들고 스트림의 내용에서 초기화합니다. 이는 OleCreatePictureIndirect(NULL, ...) 뒤에 IPersistStream::Load를 호출하는 것과 같습니다.

구문

WINOLECTLAPI OleLoadPicturePath(
  [in]  LPOLESTR  szURLorPath,
  [in]  LPUNKNOWN punkCaller,
  [in]  DWORD     dwReserved,
  [in]  OLE_COLOR clrReserved,
  [in]  REFIID    riid,
  [out] LPVOID    *ppvRet
);

매개 변수

[in] szURLorPath

열려는 파일의 경로 또는 URL입니다.

[in] punkCaller

COM 집계에 대한 IUnknown 을 가리킵니다.

[in] dwReserved

예약되어 있습니다.

[in] clrReserved

투명하게 예약하려는 색입니다.

[in] riid

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

[out] ppvRet

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

반환 값

이 함수는 E_OUTOFMEMORY 및 E_UNEXPECTED 표준 반환 값과 다음을 지원합니다.

반환 코드 설명
S_OK
 대화 상자가 성공적으로 만들어졌습니다.
E_FAIL
 그림 스트림을 로드할 수 없습니다.
E_POINTER
 ppvRet의 주소는 NULL입니다.
E_NOINTERFACE
 개체는 riid에 지정된 인터페이스를 지원하지 않습니다.

설명

스트림은 BMP(비트맵), JPEG, WMF(메타파일), ICO(아이콘) 또는 GIF 형식이어야 합니다.

요구 사항

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

추가 정보

OleLoadPicture