ITelevisionServices::ResolveBroadcast

[This is preliminary documentation and subject to change.]

The ResolveBroadcast method creates a DAO QueryDef query that represents the specified show reference. If a start time is specified in the show reference, ResolveBroadcast returns all episodes that start at that time.

HRESULT ResolveBroadcast(
  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 ResolveBroadcast method's functionality differs from that of the ITelevisionServices::ResolveBroadcastInclusively method, which returns matching episodes that start before or end after the specified start time.

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

ResolveBroadcast 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 Guide database and does not cause another type of error.

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

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