> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XtfCreateRemoteRunClient

> XtfCreateRemoteRunClient Method

Initializes a new instance of the IXtfRemoteRunClient interface with the specified address.

## Syntax

```cpp theme={null}
HRESULT XtfCreateRemoteRunClient(
         LPCWSTR pszAddress,
         REFIID riid,
         void **ppvObject
)  
```

### Parameters

*pszAddress*\
Type: LPCWSTR

Pointer to the tools IP address of the development console to use for the new [IXtfRemoteRunClient](https://docs.xbox.com/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md).

*riid*\
Type: REFIID

Pointer that receives the instance identifier of the newly created [IXtfRemoteRunClient](https://docs.xbox.com/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md).

*ppvObject*\
Type: void \*\*

Pointer that receives a reference to the newly created [IXtfRemoteRunClient](https://docs.xbox.com/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md).

### Return value

Type: HRESULT

The result of the operation.

## Remarks

The [Remote Run Client](https://docs.xbox.com/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md) is the class which will call executables on your console.\
This class can be used to execute a wide variety of executables from test tools to common command line instructions like *kill process*.
After creating the run client, you can use its [Run](https://docs.xbox.com/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/methods/ixtfremoterunclient_run.md) function to run executables.
To run executables which require input or output, you will need to use the [IXtfRemoteRunCallback's interface](https://docs.xbox.com/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md) as a parameter to the [Run](https://docs.xbox.com/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/methods/ixtfremoterunclient_run.md) function.

## Requirements

**Header:** xtfremoterun.h

**Library:** xtfremoterun.lib

**Supported platforms:** Windows (for XBOX console tools)

## See also

[IXtfRemoteRunClient](https://docs.xbox.com/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)\
[IXtfRemoteRunClient::Run](https://docs.xbox.com/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/methods/ixtfremoterunclient_run.md)\
[IXtfRemoteRunCallback Interface](https://docs.xbox.com/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)


## Related topics

- [XtfRemoteRun Members (API contents)](https://docs.xbox.com/reference/tools/xtf/xtfremoterun/xtfremoterun_members.md)
- [IXtfRemoteRunClient Interface (Interface contents)](https://docs.xbox.com/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)
- [Run](https://docs.xbox.com/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/methods/ixtfremoterunclient_run.md)
- [IXtfRemoteRunCallback Interface (Interface contents)](https://docs.xbox.com/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)
- [Input](https://docs.xbox.com/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_input.md)