ITelevisionServices::get_SystemFile

[This is preliminary documentation and subject to change.]

The get_SystemFile method retrieves a read-only value that specifies the name of the Microsoft® Jet database .mdw file used by TSS.

HRESULT get_SystemFile(
  BSTR *pbstrRetVal  
);
 

Parameters

pbstrRetVal
Pointer to a BSTR that receives the file name.

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

Applications that use TSS must open the TSS system database using the .mdw file specified by get_SystemFile, not the default .mdw file recorded in the registry. Applications do so by setting the SystemDB property of the DAO database engine to the specified .mdw file before opening the database.

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