ITelevisionServices::TuningSpaceNumberFromName

[This is preliminary documentation and subject to change.]

The TuningSpaceNumberFromName method maps a user-readable string naming a tuning space (for example, "Cable" or "Broadcast") to the numeric identifier for that tuning space in the Guide database.

HRESULT TuningSpaceNumberFromName(
  BSTR  Name,      // in
  long * plRetVal  // out
);
 

Parameters

Name

Name for the tuning space in the Guide database.

plRetVal

Address where this method returns the numeric identifier for the tuning space.

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

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::TuningSpaceNameFromNumber