---
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 GetMainWindowHandleAsInt component

# Use the GetMainWindowHandleAsInt 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 as an integer by
using the GetMainWindowHandleAsInt component in RPA Desktop Design Studio.

## Before you begin

Role required: none

## About this task

You can configure the properties for the GetMainWindowHandleAsInt 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 GetMainWindowHandleAsInt 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 GetMainWindowHandleAsInt to the corresponding ports of the other components as described in the following table.  
   {#use-sysprocess-getmainwinhandleasInt__table_jnw_jn1_krb__entry__3}

   | Port type | Purpose of connection | Mandatory? |
   |-|-|-|
   | Data In (String) | Takes the Process ID of the Window from a previously executed component. | Yes |
   | Data Out (Integer) | Returns the IntPtr value of the specified process as an integer 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-getmainwinhandleasInt__table_jnw_jn1_krb}
5. **Optional:** To test the component, under the DESIGN tab, click Run.

*[\>]: and then