ICeFileFilterSite::OpenSourceFile

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method is called by a file filter to open a source file.

Syntax

STDMETHODIMP ICeFileFilterSite::OpenSourceFile(
  int nHowToOpenFile,
  LPVOID* ppObj
);

Parameters

• nHowToOpenFile
  [in] Specifies how the source file is to be opened. It is one of the following values.

  Value	Description
  PF_OPENFLAT	Open as a flat file.
  PF_OPENCOMPOUND	Open as an OLE compound file. Note that Windows Embedded CE does not support compound files.

• ppObj
  [out] Pointer to an LPVOID variable that receives an IStream pointer if nHowToOpenFile is PF_OPENFLAT, or an IStorage pointer if nHowToOpenFile is PF_OPENCOMPOUND. This object must be released using the ICeFileFilterSite::CloseSourceFile method before returning to the mobile Internet browser.

Return Value

Returns NOERROR if the method completed successfully, otherwise returns HRESULT_FROM_WIN32.

Remarks

OpenSourceFile opens the file specified by the CFF_SOURCEFILE structure. Windows Embedded CE Explorer passes a pointer to this structure in the call to the file filter's ICeFileFilter::NextConvertFile method.

Requirements

See Also

Reference

ICeFileFilterSite::CloseSourceFile
ICeFileFilter::NextConvertFile
CFF_SOURCEFILE