Windows Media Player 11 SDK IWMPSettings::get_invokeURLs 

Windows Media Player SDK banner art

Previous Next

IWMPSettings::get_invokeURLs

The get_invokeURLs method retrieves a value indicating whether URL events should launch a Web browser.

Syntax

  

Parameters

pfInvokeURLs

[out]  Pointer to a VARIANT_BOOL indicating whether URL events should launch a Web browser. The default is TRUE.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.

Remarks

Digital media files and streams can contain URL script commands. When a URL script command is sent to the Windows Media Player control, it is passed first to the ScriptCommand event handler regardless of the value retrieved by get_invokeURLs. After ScriptCommand exits, Windows Media Player checks the VARIANT_BOOL retrieved by get_invokeURLs to determine whether to launch the default Web browser with the URL. You can selectively display URLs by checking them in ScriptCommand and setting put_invokeURLs as needed.

Windows Media Player 10 Mobile: This method always retrieves a VARIANT_BOOL set to FALSE.

Requirements

Version: Windows Media Player 9 Series or later.

Header: Include wmp.h.

Library: Use wmp.dll.

See Also

Previous Next