> ## 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 IXtfRemoteRunClient::Run

> Método IXtfRemoteRunClient::Run

# Método IXtfRemoteRunClient::Run

Executa um determinado comando no console.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
public:
HRESULT Run(
         LPCWSTR pszCommandLine,
         LPCWSTR pszWorkingDirectory,
         DWORD dwFlags,
         DWORD dwPeriod,
         IXtfRemoteRunCallback *pCallback
)  
```

<a id="ID4EG" />

<a id="parametersSection" />

### Parâmetros

*pszCommandLine*\
Tipo: LPCWSTR

A linha de comando a ser executada no console remoto.

*pszWorkingDirectory*\
Tipo: LPCWSTR

O diretório de trabalho no console remoto.

*dwFlags*\
Tipo: DWORD

Um ou mais dos sinalizadores descritos em Comentários.

*dwPeriod*\
Tipo: DWORD

Quando a saída é redirecionada, ela é agrupada em lotes e enviada de volta ao cliente periodicamente. Esse valor especifica o número de milissegundos entre as operações de agrupamento em lotes.

*pCallback*\
Tipo: [IXtfRemoteRunCallback \*](/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback)

Um retorno de chamada usado quando a entrada ou a saída padrão são redirecionadas.

<a id="ID4EP" />

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

Código de sucesso ou de erro HRESULT.

<a id="remarks" />

## Comentários

O parâmetro dwFlags é um AND bit a bit de qualquer um dos seguintes valores:

| Valor do sinalizador | Efeito |
| - | - |
| XTFRUN\_WAIT | Aguarda a conclusão do comando. O comportamento padrão é executar o comando e retornar imediatamente, sem aguardar a conclusão. |
| XTFRUN\_GUEST\_USER | Executa na conta de usuário convidado. O comportamento padrão é executar como o usuário do sistema com privilégios elevados. |
| XTFRUN\_REDIRECT\_INPUT | Redireciona a entrada padrão por meio do pCallback fornecido. Isso implica XTFRUN\_WAIT. |
| XTFRUN\_REDIRECT\_OUTPUT | Redireciona a saída padrão por meio do pCallback fornecido. Isso implica XTFRUN\_WAIT. |
| XTFRUN\_REDIRECT\_BOTH | Redireciona a entrada padrão e a saída padrão por meio do pCallback fornecido. Isso implica XTFRUN\_WAIT. |

O [IXtfRemoteRunCallback](/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback) contém uma função de retorno de chamada de entrada e uma de saída. Você pode preencher um ou ambos esses membros, caso precise de entrada *ou* saída para uma função, ou de entrada *e* saída para uma função.

Para obter mais informações sobre a *entrada* do retorno de chamada, confira [IXtfRemoteRunCallback::Input](/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_input).

Para obter mais informações sobre a *saída* do retorno de chamada, confira [IXtfRemoteRunCallback::Output](/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_output).

<a id="requirements" />

## Requisitos

**Cabeçalho:** xtfremoterun.h

**Biblioteca:** xtfremoterun.lib

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

## Confira também

[XtfRemoteRun](/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient)\
[IXtfRemoteRunClient](/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient)\
[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 XtfCreateRemoteRunClient](/pt-BR/reference/tools/xtf/xtfremoterun/methods/xtfremoterun_xtfcreateremoterunclient.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)
- [Interface IXtfRemoteRunCallback](/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)