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 report information it intentionally discarded during a file conversion. The file filter specifies a message that explains the data loss, and ActiveSync formats and displays the message in a message box when the file conversion is complete. The file filter can specify either the identifier of a message table resource, or the address of a buffer that contains the message string.

Syntax

STDMETHODIMP ICeFileFilterSite::ReportLoss(
  DWORD 
dw,
  LPCTSTR 
psz,
  va_list* 
Arguments
);

Parameters

dw

[in] Specifies a 32-bit message identifier. ReportLossuses ICeFileFilter::FormatMessageto format the message. If the format fails — for example, the message identifier could not be recognized — then the FormatMessagesystem function is used.

psz

[in] Pointer to the null-terminated message string to display. Should be NULL if the dwparameter is used.

Arguments

[in] Pointer to an array of 32-bit values that are used as insert values in the formatted message. %1 in the format string indicates the first value in the Argumentsarray, %2 indicates the second argument, and so on.

Return Value

None.

Remarks

The interpretation of each 32-bit value depends on the formatting information associated with the insert in the message definition. The default is to treat each value as a pointer to a null-terminated string. By default, the Argumentsparameter is of type va_list*, which is a language- and implementation-specific data type for describing a variable number of arguments.

If the Microsoft Win32 error value — passed in the dwparameter of the ReportLossmethod — to be formatted with FormatMessageis not NULL, then the Windows Embedded CE Explorer first calls the file filter's ICeFileFilter::FormatMessagemethod — that is, in the current module — to request a description of the error. If the file filter's FormatMessagefails, then the Windows Embedded CE Explorer attempts to identify the error using the system FormatMessagecall.

If dwis NULL, then the strings passed in the pszand Argumentsparameters are reported in a message by ActiveSync when the file conversion is complete. Note that only one of the parameters dwor pszshould not be NULL. That is, either a message identifier or a message string may be passed in the call to ReportLoss.

Requirements

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

See Also