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