Share via


AutomationConnectionBoundObject Class

Definition

Represents an object associated with a specific UI Automation provider connection.

public ref class AutomationConnectionBoundObject sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.UI.UIAutomation.UIAutomationContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class AutomationConnectionBoundObject final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.UI.UIAutomation.UIAutomationContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class AutomationConnectionBoundObject
Public NotInheritable Class AutomationConnectionBoundObject
Inheritance
Object Platform::Object IInspectable AutomationConnectionBoundObject
Attributes

Windows requirements

Device family
Windows 11 (introduced in 10.0.22000.0)
API contract
Windows.UI.UIAutomation.UIAutomationContract (introduced in v2.0)

Remarks

A UI Automation (UIA) client imports a connection-bound object into a remote operation, and then either uses it as the target object when calling an extension, or passes it as an operand to an extension.

The provider-side extension handler always executes on the thread where the remote operation is evaluated. Whenever a provider sets an operand to a connection-bound object, the threading model of this object is determined by the value of the IsComThreadingRequired property on the provider’s implementation of the ICoreAutomationConnectionBoundObjectProvider interface. If this property is true and the the connection-bound object is returned in the result of the remote operation, then the connection-bound object will be bound to the apartment where the remote operation that first introduced the object was evaluated.

This object wraps an ICoreAutomationConnectionBoundObjectProvider, which is implemented by a UIA provider.

Properties

Connection

Gets the connection details for the connection-bound object.

Applies to

See also