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

# Run

> Método IXtfRemoteRunClient::Run

# Método IXtfRemoteRunClient::Run

Executa um determinado comando no console.

## Sintaxe

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

### 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 \*](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)

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

### Valor retornado

Tipo: HRESULT

Código de sucesso ou de erro HRESULT.

## 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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md) 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](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_input.md).

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

## Requisitos

**Cabeçalho:** xtfremoterun.h

**Biblioteca:** xtfremoterun.lib

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

## Confira também

[XtfRemoteRun](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)\
[IXtfRemoteRunClient](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)\
[IXtfRemoteRunCallback](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)


## Related topics

- [Run Task](https://docs.xbox.com/api-reference/scheduledtask/run-task.md)
- [XAsyncRun](https://docs.xbox.com/pt-BR/reference/system/xasync/functions/xasyncrun.md)
- [Execução (wdRun.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/console_commandlinetools/wdrun.md)
- [XtfCreateRemoteRunClient](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfremoterun/methods/xtfremoterun_xtfcreateremoterunclient.md)
- [Interface IXtfRemoteRunCallback (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)