IWMEncPushDistribution.Template
![]() |
The Template property specifies and retrieves the name of an existing publishing point from which to copy settings.
Syntax
IWMEncPushDistribution.Template = String
String = IWMEncPushDistribution.Template
Parameters
This property takes no parameters.
Property Value
A String that contains the name of an existing publishing point.
If this property fails, it returns an error number.
| Return code | Number | Description |
| NS_E_INVALIDCALL_WHILE_ENCODER_RUNNING | 0xC00D1B66L | This property cannot be set while the encoder engine is running. |
Remarks
Before an encoding session, create a publishing point on a Windows Media server and then configure it with the settings you want to use as a template for future publishing points. During an encoding session, you can create a new publishing point and use the Template property to specify the publishing point from which to copy settings. If you do not use the Template property, new publishing points are created using the default settings.
Note You must have access permission to the Windows Media Services service through DCOM, and the encoding computer must have write access on the Windows Media server to be able to push a stream to it. For more information about configuring publishing points, see the Windows Media Services Help.
Example Code
' Create a WMEncoder object.
Dim Encoder As WMEncoder
Set Encoder = New WMEncoder
' Configure the encoding session including the input sources and profile.
' Create a push distribution object.
Dim PushDist As IWMEncPushDistribution
Set PushDist = Encoder.Broadcast
' Declare variables.
Dim sServerName As String
Dim sPubPoint As String
Dim sPubTemplate As String
Dim sMyNSCFile As String
Dim sMyNSCURL As String
Dim sMyASXFile As String
Dim sBrdcstInfo As String
' Provide values for the following variables.
sServerName = "YOURSERVERNAME:PORTNUMBER"
sPubPoint = "PUBLISHING_POINT_NAME"
sPubTemplate = "EXISTING_PUBLISHING_POINT_NAME"
sMyNSCFile = "NAME OF THE NSC FILE TO CREATE"
sMyNSCURL = "URL TO THE NSC FILE YOU CREATE"
sMyASXFile = "NAME OF THE ANNOUNCMENT FILE"
sBrdcstInfo = "NAME OF THE BROACAST INFORMATION FILE"
' Specify the server name, publishing point, and an existing publishing point,
' and then generate an .nsc file and announcement file.
PushDist.ServerName = sServerName
PushDist.PublishingPoint = sPubPoint
PushDist.Template = sPubTemplate
' Specify whether to destroy the publishing point.
PushDist.AutoRemovePublishingPoint = True
' Initialize the encoding session.
Encoder.PrepareToEncode True
' Generate the announcement file.
PushDist.GenerateMulticastInfoFile sMyNSCFile
PushDist.GenerateAnnouncementFile sMyNSCURL, sMyASXFile
' Start encoding.
Encoder.Start
Requirements
Reference: Windows Media Encoder
Library: wmenc.exe
See Also
.gif)