Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method is called by a file filter to open a destination file.

Syntax

STDMETHODIMP IPegasusFileFilterSite::OpenDestinationFile(
  int 
nHowToOpenFile,
  LPCSTR 
pszFullpath,
  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 Embedded 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 will be used.

ppObj

[out] Pointer to an LPVOIDvariable that receives an IStreampointer if nHowToOpenFileis PF_OPENFLAT, or an IStoragepointer if nHowToOpenFileis PF_OPENCOMPOUND. This object must be released using the IPegasusFileFilterSite::CloseDestinationFilemethod before returning to the mobile Internet browser.

Return Value

Returns NOERROR if the method completed successfully, otherwise returns HRESULT_FROM_WIN32.

Remarks

The default destination file name and path are specified in the PFF_DESTINATIONFILEstructure that is passed in to the call to IPegasusFileFilter::NextConvertFile. The default path is temporary and is managed by the mobile Internet browser. For example, if the user drags a bitmap file named Tmp.bmp from the desktop computer to the Handheld PC, 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 OpenDestinationFilecan be called only once within a specified call to IPegasusFileFilter::NextConvertFile.

Requirements

Header replfilt.h
Library coredll.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also