---
sourceDocument: Brazil Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/integrate-applications

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Use the GetMainWindowHandle component

# Use the GetMainWindowHandle component {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Retrieve the window handle of a main window of an active process by using the
GetMainWindowHandle component in RPA Desktop Design Studio. This component accepts
the Process ID as input and returns the Integer value of the specified process.

## Before you begin

Role required: none

## About this task

You can configure the properties for the GetMainWindowHandle component. For more
information about these properties, see [Properties of the System Process components](https://www.servicenow.com/docs/36_MIo0ZHxwuoRDlH3MvNQ "Learn about the properties of the System Process components in RPA Desktop Design Studio.").

## Procedure

1. In the Toolbox pane, navigate to UtilitiesSystem Process.
2. Drag the GetMainWindowHandle component to the Design surface.
3. To configure the input fields, see [Configure port properties](https://www.servicenow.com/docs/ED3jBpqtlHH8p~yFFmyRBQ "Configure how data is passed to the input fields of a component or method in RPA Desktop Design Studio.").
4. Connect the data and control ports of the GetMainMainWindowHandle to the corresponding ports of the other component as described in the following table.  
   {#use-sysprocess-getmainwindhandle__table_jnw_jn1_krb__entry__3}

   | Port type | Purpose of connection | Mandatory? |
   |-|-|-|
   | Data In (ProcessId) | Takes the process ID of the window as a string from a previously executed component. | Yes |
   | Data Out (Integer) | Returns the Windows handle of the specified process and passes to the next component. | Yes |
   | Control In | Connects to the Control Out port of one or more components. | Yes |
   | Control Out | Connects to the Control In port of another component or the default end component. | No |
   [ ]

   {#use-sysprocess-getmainwindhandle__table_jnw_jn1_krb}
5. **Optional:** To test the component, under the DESIGN tab, click Run.

*[\>]: and then