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).
Remarks
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
)

Parameters

desc
GuiSessionDescription for filtering the open sessions.

Return Value

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