Attach Method (GuiSessionFactory)
Returns a new IGuiSession instance that is attached to a session that was not opened by UFT Developer (for example, a session that was opened manually or by the AUT).
GuiSessionDescription is used only when attaching to the session so transient properties like GuiSessionDescription.Name can be used.

UFT Developer recognizes SAP GUI Session and tabs that it opens (for example, via Launch(String)). If a GUI Session is opened outside of the UFT Developer context, you need to use the Attach method to acquire the GUI session.

C# Syntax

public static IGuiSession Attach( 
   GuiSessionDescription desc


GuiSessionDescription for filtering the open sessions.

Return Value

IGuiSession for the launched session if a single matching sessions was found.
HP.LFT.SDK.ReplayObjectNotFoundExceptionNo open sessions matches the description.
HP.LFT.SDK.ReplayObjectNotUniqueExceptionMore than one session matches the description.