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

# XtfCreateRemoteRunClient Method

> XtfCreateRemoteRunClient Method

# XtfCreateRemoteRunClient Method

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

<a id="syntaxSection" />

## Syntax

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

<a id="ID4EG" />

<a id="parametersSection" />

### Parameters

*pszAddress*\
Type: LPCWSTR

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

*riid*\
Type: REFIID

Pointer that receives the instance identifier of the newly created [IXtfRemoteRunClient](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient).

*ppvObject*\
Type: void \*\*

Pointer that receives a reference to the newly created [IXtfRemoteRunClient](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient).

<a id="ID4EN" />

<a id="retvalSection" />

### Return value

Type: HRESULT

The result of the operation.

<a id="remarksSection" />

## Remarks

The [Remote Run Client](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient) 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](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/methods/ixtfremoterunclient_run) function to run executables.
To run executables which require input or output, you will need to use the [IXtfRemoteRunCallback's interface](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback) as a parameter to the [Run](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/methods/ixtfremoterunclient_run) function.

<a id="requirements" />

## Requirements

**Header:** xtfremoterun.h

**Library:** xtfremoterun.lib

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

## See also

[IXtfRemoteRunClient](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient)\
[IXtfRemoteRunClient::Run](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/methods/ixtfremoterunclient_run)\
[IXtfRemoteRunCallback Interface](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback)


## Related topics

- [IXtfRemoteRunClient Interface](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)
- [IXtfRemoteRunClient::Run Method](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/methods/ixtfremoterunclient_run.md)
- [IXtfRemoteRunCallback::Input Method](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_input.md)
- [IXtfRemoteRunCallback::Output Method](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_output.md)
- [IXtfFileIOClient::CreateDirectory Method](/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/createdirectory-ixtffileioclient-xtffileio-xbox-microsoft-m.md)