ITsSbResourceNotificationEx::NotifyClientConnectionStateChangeEx method (sbtsv.h)

Article
02/22/2024

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

Syntax

HRESULT NotifyClientConnectionStateChangeEx(
  [in] BSTR                           userName,
  [in] BSTR                           domain,
  [in] BSTR                           initialProgram,
  [in] BSTR                           poolName,
  [in] BSTR                           targetName,
  [in] CONNECTION_CHANGE_NOTIFICATION connectionChangeType
);

Parameters

[in] userName

The user name.

[in] domain

The user domain.

[in] initialProgram

The initial program.

[in] poolName

The name of the pool.

[in] targetName

The name of the target.

[in] connectionChangeType

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.

Return value

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

Requirements

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