IWMPSettings::put_baseURL method (wmp.h)
[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The put_baseURL method specifies the base URL used for relative path resolution with URL script commands that are embedded in digital media files.
Syntax
HRESULT put_baseURL(
[in] BSTR bstrBaseURL
);
Parameters
[in] bstrBaseURL
BSTR containing the base URL.
Return value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
|
The method succeeded. |
Remarks
This method specifies the base HTTP URL that is passed as the command parameter by the ScriptCommand event. The base URL is concatenated with the relative URL as follows:
- A trailing forward slash (/) is added to the value specified in the put_baseURL method.
- A leading period, backward slash, or forward slash character (., \, and /) is deleted from the relative URL.
- The relative URL is added to the end of the base URL.
- All slash characters in the resulting fully qualified URL are pointed in the same direction (converted to forward or backward slashes) based on the direction of the first slash character encountered in the new URL.
The Windows Media Player control does not support the use of two periods (..) in the relative URL to indicate the parent of the current location.
Windows Media Player 10 Mobile: This method always returns E_INVALIDARG.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Media Player 9 Series or later. |
| Target Platform | Windows |
| Header | wmp.h |
| DLL | Wmp.dll |