ITelevisionServices::MakeRemoteBroadcastSchedule

[This is preliminary documentation and subject to change.]

The MakeRemoteBroadcastSchedule method is a wrapper for the ITelevisionServices::MakeLocalBroadcastSchedule method that substitutes wildcard values for computer- or locality-specific members.

HRESULT MakeRemoteBroadcastSchedule(
  BSTR  EpisodeTitle,  // in
  BSTR  Network,       // in
  VARIANT  Time,       // in
  BSTR  *pbstrRetVal   // out
);
 

Parameters

EpisodeTitle

Title for the show reference.

Network

Network for the show reference.

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 Visual Basic; 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 MakeRemoteBroadcastSchedule method 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::MakeLocalBroadcastSchedule, ITelevisionServices::SplitBroadcastSchedule, ITelevisionServices::SplitSimpleBroadcastSchedule