ITsSbResourceNotification::NotifyClientConnectionStateChange method (sbtsv.h)

Article
07/27/2022

Notifies registered plug-ins about state changes in a client connection.

Syntax

HRESULT NotifyClientConnectionStateChange(
  [in] CONNECTION_CHANGE_NOTIFICATION ChangeType,
  [in] ITsSbClientConnection          *pConnection
);

Parameters

[in] ChangeType

The type of change that has occurred. This parameter can be one of the following values.

CONNECTION_REQUEST_PENDING

A client request is pending a session logon from a user.

CONNECTION_REQUEST_FAILED

RD Connection Broker failed to process the request. This value is issued just before RD Connection Broker deletes the connection request from its store.

CONNECTION_REQUEST_TIMEDOUT

The request timed out. This generally means that either the user has canceled the request or was unable to log on because of network connectivity issues. This value is issued just before RD Connection Broker deletes the connection request from its store.

CONNECTION_REQUEST_SUCCEEDED

The user successfully logged on to the target computer. This value is issued just before RD Connection Broker deletes the connection request from its store.

CONNECTION_REQUEST_CANCELLED

RD Connection Broker canceled a connection request

because the connection request was being processed while the RD Connection Broker service was stopping.

[in] pConnection

A pointer to an ITsSbClientConnection connection object.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

RD Connection Broker calls the NotifyClientConnectionStateChange method to notify registered plug-ins about state changes in a client connection.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows Server 2012
Target Platform	Windows
Header	sbtsv.h