ITelevisionServices::MakeLocalBroadcastSchedule

[This is preliminary documentation and subject to change.]

The MakeLocalBroadcastSchedule method returns a correctly formatted show reference.

HRESULT MakeLocalBroadcastSchedule(
  BSTR  EpisodeTitle,  // in
  short  Channel,      // in
  BSTR  Network,       // in
  BSTR  Station,       // in
  long  TuningSpace,  // in
  VARIANT  Time,       // in
  BSTR  *pbstrRetVal   // out
);
 

Parameters

EpisodeTitle

Title for the show reference.

Channel

Channel for the show reference. To specify any channel, set this parameter to the wildcard value of –1.

Network

Network for the show reference.

Station

Station for the show reference. To specify any station, set this parameter to the wildcard value of NULL.

TuningSpace

Tuning space for the show reference. To specify any tuning space, set this parameter to the wildcard value of –1.

Time

Date and time for the show reference. The Time parameter is a VARIANT that can contain either a DATE value or a pointer to an ITaskTrigger interface. The former can be used from the Microsoft® Visual Basic® development system; the latter permits ambiguous dates and times, which can be resolved to repeating show schedules.

You can create a show reference with an ambiguous date or time by passing a pointer to an ITaskTrigger interface in which the date or time member of the TASK_TRIGGER structure, or both, are set to –1. For more information on working with ambiguous dates and times, see Ambiguous Triggers. To locate more information about ITaskTrigger and TASK_TRIGGER, see Further Information on Television Services for the Client.

The DATE data type does not support ambiguous date or time values.

pbstrRetVal

Address where this method returns a properly formatted show reference.

Return Values

Returns an HRESULT indicating success or failure. If the method succeeds, it returns S_OK. Otherwise, it returns an error code. For specific error codes, see the Winerror.h header file. To locate more information about Winerror.h, see Further Information on Television Services for the Client.

Remarks

The data passed in the parameters of the MakeLocalBroadcastSchedule method contains all the information necessary for making a correctly formatted show reference.

MakeLocalBroadcastSchedule does not perform any validation of the existence of the show or shows specified or more than rudimentary validation of its arguments.

QuickInfo

  Windows NT: Unsupported.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in tssadmin.odl.
  Import Library: Included as a resource in tssadmin.dll.
  Unicode: Yes.

See Also

ITelevisionServices::MakeRemoteBroadcastSchedule, ITelevisionServices::SplitBroadcastSchedule, ITelevisionServices::SplitSimpleBroadcastSchedule