IMFPMediaItem::GetURL method (mfplay.h)

Important Deprecated. This API may be removed from future releases of Windows. Applications should use the Media Session for playback.

Gets the URL that was used to create the media item.

Syntax

HRESULT GetURL(
  [out] LPWSTR *ppwszURL
);

[out] ppwszURL

Receives a pointer to a null-terminated string that contains the URL. The caller must free the string by calling CoTaskMemFree.

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.
MF_E_NOTFOUND	No URL is associated with this media item.
MF_E_SHUTDOWN	The IMFPMediaPlayer::Shutdown method was called.

This method applies when the application calls IMFPMediaPlayer::CreateMediaItemFromURL to create a media item. If the application calls IMFPMediaPlayer::CreateMediaItemFromObject to create a media item, the GetURL method for that media item returns MF_E_NOTFOUND.

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	mfplay.h