Compartir a través de


: IHtmlTrLoadBalancer.StrGetLauncher (Método) (Microsoft.HtmlTrans)

Returns the name of the server hosting a launcher component to use for the document conversion.

Espacio de nombres:
Ensamblado: Microsoft.HtmlTrans.Interface (in microsoft.htmltrans.interface.dll)

Sintaxis

'Declaración
Function StrGetLauncher ( _
    strTaskName As String _
) As String
'Uso
Dim instance As IHtmlTrLoadBalancer
Dim strTaskName As String
Dim returnValue As String

returnValue = instance.StrGetLauncher(strTaskName)
string StrGetLauncher (
    string strTaskName
)

Parámetros

  • strTaskName
    The name assigned to the document conversion task. Receives a value of TransformCurrentlyRunning if a task with the specified name is already running.

Valor devuelto

A string that contains a Uniform Resource Identifier (URI) that identifies the server hosting the launcher. Pass this value as the strLauncherUri argument to the CHICreateHtml method.

Comentarios

The handler page calls the StrGetLauncher method to determine the server to which it should forward the document conversion request. The load balancer component returns the name of the server that currently has the fewest document conversion tasks assigned to it. The handler then passes this value as the strLauncherUri argument to the CHICreateHtml method.

The strTaskName value is an arbitrary string value that the load balancer uses to track server load and task status. Because only one instance of a task can run at a time, choose a task name that is more or less specific, depending on how many similar concurrent requests running on the server are acceptable.

Ejemplo

For a code example that demonstrates the use of the IHtmlTrLoadBalancer and IHtmlTrLauncher interfaces, including the StrGetLauncher method, see the CHICreateHtml method.

Vea también

Referencia

IHtmlTrLoadBalancer (Interfaz)
IHtmlTrLoadBalancer (Miembros)
Microsoft.HtmlTrans (Espacio de nombres)