ICeFileFilterSite::OpenDestinationFile
This method is called by a file filter to open a destination file.
STDMETHODIMP ICeFileFilterSite::OpenDestinationFile(
int nHowToOpenFile,
LPCSTR pszFullpath,
LPVOID *ppObj);
Parameters
nHowToOpenFile
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
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
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 Pocket Internet Explorer.
Return Values
NOERROR indicates success. An HRESULT_FROM_WIN32 error value indicates failure.
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 Windows CE Services. For example, if the user drags a bitmap file named Tmp.bmp from the desktop computer to the mobile device, 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.
Requirements
| Runs On | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 2.0 and later | Replfilt.h |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
ICeFileFilter::NextConvertFile, ICeFileFilterSite::CloseDestinationFile, CFF_DESTINATIONFILE
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.