> ## 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.

# Método XtfCreateRemoteRunClient

> Método XtfCreateRemoteRunClient

# Método XtfCreateRemoteRunClient

Inicializa uma nova instância da interface IXtfRemoteRunClient com o endereço especificado.

<a id="syntaxSection" />

## Sintaxe

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

<a id="ID4EG" />

<a id="parametersSection" />

### Parâmetros

*pszAddress*\
Tipo: LPCWSTR

Ponteiro para o endereço IP de ferramentas do console de desenvolvimento a ser usado para o novo [IXtfRemoteRunClient](/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient).

*riid*\
Tipo: REFIID

Ponteiro que recebe o identificador de instância do [IXtfRemoteRunClient](/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient) recém-criado.

*ppvObject*\
Tipo: void \*\*

Ponteiro que recebe uma referência ao [IXtfRemoteRunClient](/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient) recém-criado.

<a id="ID4EN" />

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

O resultado da operação.

<a id="remarksSection" />

## Comentários

O [Remote Run Client](/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient) é a classe que chamará executáveis no seu console.\
Essa classe pode ser usada para executar uma grande variedade de executáveis, desde ferramentas de teste até instruções comuns de linha de comando, como *kill process*.
Depois de criar o cliente de execução, você pode usar a função [Run](/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/methods/ixtfremoterunclient_run) dele para executar executáveis.
Para executar executáveis que exigem entrada ou saída, você precisará usar a [interface IXtfRemoteRunCallback](/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback) como parâmetro para a função [Run](/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/methods/ixtfremoterunclient_run).

<a id="requirements" />

## Requisitos

**Cabeçalho:** xtfremoterun.h

**Biblioteca:** xtfremoterun.lib

**Plataformas com suporte:** Windows (para ferramentas de console XBOX)

## Confira também

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


## Related topics

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