ICeFileFilterSite::OpenDestinationFile (Windows CE 5.0)
This method is called by a file filter to open a destination file.
STDMETHODIMP ICeFileFilterSite::OpenDestinationFile(intnHowToOpenFile,LPCSTRpszFullpath,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 CE does not support compound files. - pszFullpath
[in] Pointer to the null-terminated string that contains the name of the file to open to override the default destination file name. If this parameter is NULL, the default destination file name is used. - 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::CloseDestinationFile method before returning to the mobile Internet browser, which is Pocket Internet Explorer.
Return Values
Returns NOERROR if the method completed successfully, otherwise returns HRESULT_FROM_WIN32.
Remarks
The default destination file name and path are specified in the CFF_DESTINATIONFILE structure is passed in to the call to ICeFileFilter::NextConvertFile. The default path is temporary and is managed by ActiveSync. For example, if the user drags a bitmap file named Tmp.bmp from the desktop computer to the Windows Mobile–based, the default destination file name is Tmp.2bp.
The temporary destination file path must be located on the desktop computer, but the path can be modified as desired.
Note that OpenDestinationFile can be called only once within a specified call to ICeFileFilter::NextConvertFile.
Windows Mobile Remarks
The mobile Internet browser for Windows Mobile-based devices is Internet Explorer Mobile.
Requirements
OS Versions: Windows CE 2.0 and later.
Header: Replfilt.h.
Link Library: Coredll.lib.
See Also
ICeFileFilter::NextConvertFile | ICeFileFilterSite::CloseDestinationFile | CFF_DESTINATIONFILE
Send Feedback on this topic to the authors