ITuningSpace::get_DefaultLocator method (tuner.h)
[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]
The get_DefaultLocator method retrieves the default locator for this tuning space.
Syntax
HRESULT get_DefaultLocator(
[out] ILocator **LocatorVal
);
Parameters
[out] LocatorVal
Address of a variable that receives a pointer to ILocator interface. The caller must release the interface.
Return value
Returns S_OK if successful. If the method fails, error information can be retrieved using the standard COM IErrorInfo interface.
Remarks
The tuning space might not have a default locator. It is the application's responsibility to provide a default locator for the tuning space if needed.
If the tuning space does not have a default locator, this method succeeds but returns the value NULL in the ppLocatorVal parameter. Check for a NULL value before attempting to dereference the pointer.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows�XP [desktop apps only] |
| Minimum supported server | None supported |
| Target Platform | Windows |
| Header | tuner.h |