IWTSSBPlugin::WTSSBX_MachineChangeNotification Method

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

Syntax

C++
HRESULT WTSSBX_MachineChangeNotification(
  [in]  WTSSBX_NOTIFICATION_TYPE NotificationType,
  [in]  long MachineId,
  [in]  WTSSBX_MACHINE_INFO *pMachineInfo
);

Parameters

NotificationType [in]

A value of the WTSSBX_NOTIFICATION_TYPE enumeration type that indicates the type of event that occurred.

MachineId [in]

The ID of the server on which the change occurred.

pMachineInfo [in]

A pointer to a WTSSBX_MACHINE_INFO structure that contains information about the server that changed. Only the members that changed are reported in this structure. The other members are set to zero.

Return Value

Returns S_OK if successful.

Remarks

Terminal Services Session Broker (TS Session Broker) calls this method whenever an important change in the server environment occurs. For example, changes that would trigger a call include when:

  • A server joins or leaves a farm in TS Session Broker.
  • A server changes its drain state.
  • A server IP address changes.
  • A server's maximum session limit changes.

Your implementation of this method must return S_OK immediately if successful.

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

IWTSSBPlugin

Send comments about this topic to Microsoft

Build date: 10/19/2009

Tags :


Page view tracker