ITelevisionServices::ResolveBroadcastInclusively

[This is preliminary documentation and subject to change.]

The ResolveBroadcastInclusively method creates a DAO QueryDef definition that represents the specified show reference. If a start time is specified in the show reference, ResolveBroadcastInclusively returns all matching episodes that start before or end after that time.

HRESULT ResolveBroadcastInclusively(
  BSTR  Workspace,     // in
  BSTR  QueryName,     // in
  BSTR  ShowReference  // in
);
 

Parameters

Workspace

Name of the DAO workspace in which to create the query. This workspace can be either preexisting or newly created.

QueryName

Name of the new query.

ShowReference

Show reference used to generate the query. If the ShowReference parameter is unambiguous, the query generated represents a single episode. If ShowReference is ambiguous, it can represent multiple or repeating broadcasts. For example, to generate a query that returns each weekly episode of a show you can specify the time and channel of that show, leaving the date ambiguous.

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 and Dbdaoerr.h header files. To locate more information about Winerror.h and Dbdaoerr.h, see Further Information on Television Services for the Client.

Remarks

The ResolveBroadcastInclusively method's functionality differs from that of the ITelevisionServices::ResolveBroadcast method, which returns matching episodes that start at the specified start time. As an example of ResolveBroadcastInclusively functionality, if the start time specified in the show reference is 11:15 A.M., ResolveBroadcastInclusively creates a QueryDef that returns shows that start any time before and end any time after 11:15 A.M.

If a QueryDef of the same name already exists, calling ResolveBroadcastInclusively deletes it.

ResolveBroadcastInclusively can return an error in which the QueryDef has an empty result set. Such an error occurs if the ShowReference specified does not match anything in the database and does not cause another type of error.

The application that calls ResolveBroadcast must delete the QueryDef object after use.

ResolveBroadcastInclusively ignores the show reference's end time value.

ResolveBroadcastInclusively is called internally by the enhancement filter.

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::ResolveBroadcast, ITelevisionServices::ResolveScheduledReminders