IWMSCacheItemDescriptor.GetCacheUrl (Visual Basic .NET)

  • Article

banner art

Previous Next

IWMSCacheItemDescriptor.GetCacheUrl (Visual Basic .NET)

The GetCacheUrl method retrieves the URL that identifies the location of the cached content on the server.

Syntax

Parameters

pbstrCacheUrl

[out] Reference to a String containing the URL.

Return Values

This method does not return a value. To report an error, the plug-in can throw a COMException object to the server. If the plug-in uses the IWMSEventLog object to log error information, it is recommended that it throw NS_E_PLUGIN_ERROR_REPORTED (0xC00D157D). Typically, the server attempts to make plug-in error information available to the server object model, the Windows Event Viewer, and the troubleshooting list in the details pane of the Windows Media Services MMC. However, if the plug-in uses the IWMSEventLog object to send custom error information to the Windows Event Viewer, throwing NS_E_PLUGIN_ERROR_REPORTED stops the server from also logging to the event viewer. For more information about plug-in error information, see Identifying Plug-in Errors.

Example Code

The following example assumes that the cache plug-in makes use of the .NET DataSet collection of DataTable objects. Each DataRow object in the data table represents one IWMSCacheDescriptor object.

Imports Microsoft.WindowsMediaServices.Interop
Imports System.Runtime.InteropServices

Public Sub GetCacheUrl(ByRef Url As String) _
  Implements IWMSCacheItemDescriptor.GetCacheUrl

    Try
      Url = Convert.ToString(Row("CacheUrl"))

    Catch Exc As Exception
      Throw New COMException()

    End Try

End Sub

Requirements

Reference: Add a reference to Microsoft.WindowsMediaServices.

Namespace: Microsoft.WindowsMediaServices.Interop.

Assembly: Microsoft.WindowsMediaServices.dll.

Library: WMSServerTypeLib.dll.

Platform: Windows Server 2003, Enterprise Edition; Windows Server 2003, Datacenter Edition; Windows Server 2008.

See Also

Previous Next