Click to Rate and Give Feedback

  Switch on low bandwidth view
IWTSSBPlugin Interface

Used to extend the capabilities of Remote Desktop Connection Broker (RD Connection Broker).

Implement this interface when you want to provide a plug-in that overrides the redirection logic of RD Connection Broker.

Methods

The IWTSSBPlugin interface inherits the methods of the IUnknown interface.

In addition, IWTSSBPlugin defines the following methods.

MethodDescription

Initialize

Initializes the plug-in and returns a value that indicates the redirection capabilities of the plug-in.

Terminated

Notifies the plug-in that RD Connection Broker is about to destroy the plug-in.

WTSSBX_GetMostSuitableServer

Returns the ID of the server to which RD Connection Broker should direct the incoming connection.

WTSSBX_GetUserExternalSession

Directs an incoming connection to an external computing resource.

WTSSBX_MachineChangeNotification

Notifies the plug-in that a change occurred in the server environment.

WTSSBX_SessionChangeNotification

Notifies the plug-in that a change, such as a logon, logoff, disconnect, or reconnect, occurred in a user session.

 

Remarks

RD Connection Broker calls the WTSSBX_GetUserExternalSession method so that the plug-in can direct an incoming connection to a computer that does not belong to a farm in RD Connection Broker.

Alternatively, RD Connection Broker calls the WTSSBX_GetMostSuitableServer method so that the plug-in can direct an incoming connection to a computer that does belong to a farm in RD Connection Broker.

These methods reference an individual server in the farm by using the unique MachineId assigned to the server by RD Connection Broker. When a server joins a farm in RD Connection Broker, RD Connection Broker calls the WTSSBX_MachineChangeNotification method to notify the plug-in of the change and pass the MachineId of the new server to the plug-in.

Requirements

Minimum supported clientNone supported
Minimum supported serverWindows Server 2008
HeaderTssbx.h
IDLTssbx.idl
IIDIID_IWTSSBPlugin is defined as DC44BE78-B18D-4399-B210-641BF67A002C

See Also

Remote Desktop Connection Broker Extensibility

Send comments about this topic to Microsoft

Build date: 6/26/2009

Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Processing
© 2009 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker