Edit

Share via

OleLoadPictureFile function (olectl.h)

  • Article

Creates an IPictureDisp object from a picture file on disk.

Syntax

WINOLECTLAPI OleLoadPictureFile(
  [in]  VARIANT    varFileName,
  [out] LPDISPATCH *lplpdispPicture
);

Parameters

[in] varFileName

The path and name of the picture file to load.

[out] lplpdispPicture

The location that receives a pointer to the IPictureDisp object.

Return value

This method returns standard COM error codes in addition to the following values.

Return code Description
S_OK
 The method completed successfully.
CTL_E_INVALIDPICTURE
 Invalid picture file.

Remarks

Recognized graphic formats include bitmap (.bmp), JPEG (.jpg), GIF (.gif), and PGN (.png) files.

Requirements

Requirement Value
Target Platform Windows
Header olectl.h
Library OleAut32.lib
DLL OleAut32.dll