ICeFileFilterSite::OpenDestinationFile

Article
08/28/2006

The OpenDestinationFile method is called by a file filter to open a destination file.

Syntax

HRESULT OpenDestinationFile (
  int nHowToOpenFile,
  LPCTSTR pszFullpath,
  LPVOID * ppObj
);

Parameters

nHowToOpenFile
[in] Specifies how to open a destination file. See Remarks for the possible values.
pszFullpath
[in] Reference to a null-terminated string that specifies the name of the file to open to override the default destination file name.
ppObj
[out] Reference to the Windows CE IStream interface if nHowToOpenFile is CF_OPENFLAT or to the Windows CE IStorage interface if nHowToOpenFile is CF_OPENCOMPOUND. This object must be released using the ICeFileFilterSite::CloseDestinationFile method before returning to Pocket Internet Explorer.

Return Values

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, and E_UNEXPECTED, as well as the following:

S_OK
The method completed successfully.

Remarks

The following table lists the possible values for nHowToOpenFile.

Constant	Value	Description
CF_OPENFLAT	0	Open as a flat file.
CF_OPENCOMPOUND	1	Open as a COM compound file.
CF_OPENDONT	2	This constant is not used.
CF_OPENASKMEHOW	3	This constant is not used.

If pszFullpath is NULL, the default destination file name and path are used. The default file name and path are specified in the CFF_DESTINATIONFILE structure, which is passed in the call to ICeFileFilter::NextConvertFile. The default file path is temporary and is managed by Windows CE Services.

The file path must be located on the desktop computer, but the path can be modified as desired.

Note The OpenDestinationFile method can be called only once within a specified call to ICeFileFilter::NextConvertFile.

Requirements

Smartphone: Windows Mobile 2002 and later
OS Versions: Windows CE 3.0 and later
Header: replfilt.h

Share via