Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The GetProperty method retrieves a specific property from the active media element.
String = IWMSActiveMedia.GetProperty(
strProperty As String,
strLanguage As String
)
Arguments
strProperty |
[in] String containing the name of the property to retrieve. The properties are stored in a Content Description Context. This parameter can be one of the following values, or a custom value that is defined in the clientData playlist element. |
Value |
Description |
|---|---|
title |
Retrieves the content title from the content file header, if available, or from the value specified by the title attribute in the clientData element of a playlist. The value specified in the clientData element, if present, overrides the header value. |
album |
Retrieves the album name from the content file header, if available, or from the value specified by the value attribute in the clientData element of a playlist. The value specified in the clientData element, if present, overrides the header value. |
artist |
Retrieves the author of the playlist or media file from the content file header, if available, or from the value specified by the author attribute in the clientData element of a playlist. The value specified in the clientData element, if present, overrides the header value. |
bannerAbstract |
Retrieves the text to be displayed as a ToolTip for the Windows Media Player banner graphic identified by the bannerURL property. The text is retrieved from the content file header or from the bannerAbstract attribute of the clientData playlist element. The value specified in the clientData element, if present, overrides the header value. |
bannerInfoURL |
Retrieves the URL of the Web page that a user can access by clicking the Windows Media Player banner graphic identified by the bannerURL property. The URL can be retrieved from the content file header or from the bannerInfoURL attribute of the clientData playlist element. The value specified in the clientData element, if present, overrides the header value. |
bannerURL |
Retrieves the URL of a graphics file that is displayed in Windows Media Player. The URL is retrieved from the content file header or from the bannerURL attribute of the clientData playlist element. The value specified in the clientData element, if present, overrides the header value. |
copyright |
Retrieves copyright information from the content file header, if available, or from the value specified by the copyright attribute in the clientData element of a playlist. The value specified in the clientData element, if present, overrides the header value. |
genre |
Retrieves category information from the content file header, if available, or from the value specified by the genre attribute in the clientData element of a playlist. The value specified in the clientData element, if present, overrides the header value. |
logURL |
Retrieves the content description from the content file header, if available. |
WMS_CONTENT_DESCRIPTION_PLAYLIST_ENTRY_URL |
Retrieves the path to a content file. This is equivalent to the src attribute that can be specified in a playlist file. |
WMS_CONTENT_DESCRIPTION_RATING |
Retrieves rating information from the file header, if available. |
WMS_CONTENT_DESCRIPTION_ROLE |
Retrieves the role of a media element in a playlist. This value is specified by the role attribute. |
strLanguage |
[in] String containing the national language for the property. This must conform to RFC-1766. |
Remarks
The values that can be specified for the national language are identical to the HTTP language tags.
Example
The following example illustrates how to use the GetProperty method.
Requirements
Reference: Add a reference to Microsoft.WindowsMediaServices.
Namespace: Microsoft.WindowsMediaServices.Interop.
Assembly: Microsoft.WindowsMediaServices.dll.
Library: WMSServerTypeLib.dll.
Platform: Windows Server 2003 family, Windows Server 2008 family.
Return Value
A String that contains the value associated with the property.
If this method fails, it returns an error number.
Number |
Description |
|---|---|
0x8002000B |
strProperty does not exist. |
0x8007000E |
There is insufficient memory to complete the function. |
0xC00D145CL |
strLanguage is an invalid language tag or that no context description exists for the language specified. |