Platform SDK: Broadcast Architecture

IATVEFAnnouncement::SetStartStopTime

Adds a start and stop time for the current program.

HRESULT SetStartStopTime(
  DATE Start,
  DATE Stop
);

Parameters

Start
Session start time.
Stop
Session end time. This should be a value sometime in the future. If the stop time has already occurred, clients will ignore the announcement.

Return Value

Returns S_OK if the method succeeds; otherwise, an error code is returned.

Remarks

This method adds a start and stop time (the "t=" field) which is required by the SDP protocol (upon which ATVEF announcements are based). Multiple start and stop times may be added through repeated calls to this method. This is useful if the program is airing at different times during a given period. To delete all the times that have been added, call ClearAllTimes. Microsoft® WebTV® for Windows expects the stop time to be zero. For more information about announcements, see RFC 2327. For more information about ATVEF, see the ATVEF specification.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 98.
  Header: Declared in atvefsnd.idl.
  Import Library: Included as a resource in atvefsnd.dll.