IWTSProtocolListenerCallback::OnConnected method (wtsprotocol.h)

[IWTSProtocolListenerCallback::OnConnected is no longer available for use as of Windows Server 2012. Instead, use IWRdsProtocolListenerCallback::OnConnected.]

Notifies the Remote Desktop Services service that a client connection request has been received. After this method is called, the Remote Desktop Services service begins the client connection sequence.

Syntax

HRESULT OnConnected(
  [in]  IWTSProtocolConnection         *pConnection,
  [out] IWTSProtocolConnectionCallback **pCallback
);

Parameters

[in] pConnection

A pointer to an IWTSProtocolConnection interface that represents a client connection. The Remote Desktop Services service adds a reference to this object and releases it when it closes the connection.

[out] pCallback

The address of a pointer to an IWTSProtocolConnectionCallback interface used by the protocol to notify the Remote Desktop Services service about the status of a client connection. The Remote Desktop Services service adds a reference to this object and the protocol must release it when the connection is closed.

Return value

If the function succeeds, the function returns S_OK.

If the function fails, it returns an HRESULT value that indicates the error. Possible values include, but are not limited to, those in the following list. For a list of common error codes, see Common HRESULT Values.

Requirements

See also

IWTSProtocolListenerCallback