IDataListener::SubmitAnnouncement

[This is preliminary documentation and subject to change.]

The IDataListener::SubmitAnnouncement method allows an application to schedule the reception of a broadcast without an announcement being sent to the public announcement address. This method has two primary uses: to allow announcements to be distributed by other means, such as the Internet or in e-mail, and to permit filters to store announcements for presentation to a user for approval.

For example, an application might consist of a filter to store announcements that may be of interest to a user, present them to the user at some later date, and register the announcement for receipt of its broadcast at that time. Announcements delivered by this mechanism are not presented to the filters, but scheduled unconditionally for the receipt of their broadcasts.

The input parameters to this method are equivalent to the output parameters of IBroadcastFilter::Match and IBroadcastFilter::GetDisposition.

In addition to the passed parameters, SubmitAnnouncement, must be able to access the local IP address by calling the IBroadcastAnnouncment::get_LocalAddress function. Therefore; applications that use SubmitAnnouncement, must call IBroadcastAnnouncment::put_LocalAddress prior to calling SubmitAnnouncement.

HRESULT SubmitAnnouncement(
  IBroadcastAnnouncement * Announcement,  // in
  BSTR WorkingDirectory,                  // in
  BSTR Application,                       // in
  BSTR Parameters,                        // in
  long AdvanceMinutes                     // in
);
 

Parameters

Announcement
Pointer to the object containing the announcement.
WorkingDirectory
Working directory in which to launch the target application.
Application
File name of the application to be launched.
Parameters
String to be appended to the command line following the application name.
AdvanceMinutes
Number of minutes prior to the time the announced data arrives to launch the application.

Return Values

Returns an HRESULT indicating success or failure.

See Also

IBroadcastFilter::GetDisposition, IBroadcastFilter::Match