IPegasusFileFilterSite::OpenSourceFile

The IPegasusFileFilterSite::OpenSourceFile method is used by a file filter to open a source file.

Syntax

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

At a Glance

Header file: Replfilt.h
Platforms: H/PC
Windows CE versions: 1.0 and later

Parameters

nHowToOpenFile
Specifies how the source file is to be opened. This can be one of the following values:
PF_OPENFLAT
Open as a flat file.
PF_OPENCOMPOUND
Open as an OLE compound file. Note that Windows CE does not support compound files.
ppObj
Address of an LPVOID variable that will receive an IStream pointer if nHowToOpenFile is PF_OPENFLAT, or an IStorage pointer if nHowToOpenFile is PF_OPENCOMPOUND. This object must be released using the IPegasusFileFilterSite::CloseSourceFile method before returning to H/PC Explorer.

Return Values

NOERROR
OpenSourceFile was successful.

If OpenSourceFile fails, the return value is an HRESULT_FROM_WIN32 error value.

Remarks

The IPegasusFileFilterSite::OpenSourceFile method opens the file specifed by the PFF_SOURCEFILE structure. H/PC Explorer passes a pointer to this structure in the call to the file filter's IPegasusFileFilter::NextConvertFile method.

See Also

IPegasusFileFilter::NextConvertFile