[This is preliminary documentation and subject to change.]
The RemapEnhancements method maps enhancements loaded in the Guide database to their corresponding channels and episodes.
HRESULT RemapEnhancements(
Workspace *piDAOWorkspace,
);
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.
The RemapEnhancements method sets the appropriate values for the Enhancement Mapping ID field of the Channel and Episode tables in the Guide database. Loadstub automatically calls RemapEnhancements whenever new Program Guide data is loaded into the Guide database. In most cases, your application never needs to call this method explicitly.
As an example of the use of RemapEnhancements, suppose a content provider transmits enhancement data for a future episode. The enhancement filter stores the enhancement data in the Episode Enhancements table of the Guide database, even though the corresponding episode data is not yet loaded in the database. However, when episode data is loaded, the new episodes are not already matched to the previously loaded enhancement data. In other words, the new episodes' E Enhancement Mapping ID fields are blank. To correct this, Loadstub calls RemapEnhancements to map the preexisting enhancements with the new episodes.
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.
ITelevisionServices::DeleteEnhancementFromID, ITelevisionServices::DeleteOldEnhancements, ITelevisionServices::LoadEnhancement, ITelevisionServices::LoadEnhancementsFromFile