IWMSPublishingPoint.Name (Visual Basic .NET)
.gif)
| Previous | Next |
IWMSPublishingPoint.Name (Visual Basic .NET)
The Name property specifies and retrieves the name of the publishing point.
Syntax
IWMSPublishingPoint .Name = String String = IWMSPublishingPoint.Name
Property Value
A String containing the name.
If this property fails, it returns an error number.
| Number | Description |
| 0x8007000E | There is insufficient memory to complete the function. |
| 0xC00D0036L | String is already being used by another publishing point. |
| 0xC00D1455L | String contains an invalid character. Invalid characters are: & " ' < > \ and the ANSI characters 0-31 and 127. |
| 0xC00D1392L | String is longer than the maximum length allowed. |
| 0xC00D145AL | The publishing point was already removed. |
| 0xC00D1452L | The method is not supported for cache proxy publishing points. |
Remarks
The name must be unique. You can indicate the home publishing point by specifying only the forward slash character (/). There can be only one home publishing point, and it can be either a broadcast or on-demand publishing point. A home publishing point is not mandatory, but it enables clients to connect using the shorter URL formats such as protocol://server_name and protocol://server_name/file_name.
All other publishing point names must not contain a leading or trailing /, but a / character is permitted in the middle of a name. The following characters are not permitted:
< > \ ? % & ' # { } | ^ [ ] `
White spaces are permitted in the name, but the server will strip leading and trailing white spaces.
Example Code
Imports Microsoft.WindowsMediaServices.Interop
Imports System.Runtime.InteropServices
Private Sub GetSetPubPointName()
' Declare variables.
Dim Server As WMSServer
Dim PubPoints As IWMSPublishingPoints
Dim PubPoint As IWMSPublishingPoint
Dim strText As String
Try
' Create the WMSServer object.
Server = New WMSServer()
' Retrieve the IWMSPublishingPoints object.
PubPoints = Server.PublishingPoints
' Retrieve information about each publishing point.
For Each PubPoint In PubPoints
' Retrieve the displayed name of the publishing point.
strText = PubPoint.Name
' Change the name of the publishing point.
strText = "Modified Pub Point Name"
PubPoint.Name = strText
Next
Catch excCom As COMException
' TODO: Handle COM exceptions.
Catch exc As Exception
' TODO: Handle errors.
Finally
' TODO: Clean-up code goes here.
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 family, Windows ServerĀ 2008 family.
See Also
- IWMSPublishingPoint Object (Visual Basic .NET)
- IWMSPublishingPoint.Path (Visual Basic .NET)
- IWMSPublishingPoint.Type (Visual Basic .NET)
| Previous | Next |