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

> IXtfRemoteRunClient::Run (método)

# IXtfRemoteRunClient::Run (método)

Ejecuta un comando determinado en la consola.

## Sintaxis

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

### Parámetros

*pszCommandLine*\
Tipo: LPCWSTR

La línea de comandos que se va a ejecutar en la consola remota.

*pszWorkingDirectory*\
Tipo: LPCWSTR

El directorio de trabajo en la consola remota.

*dwFlags*\
Tipo: DWORD

Una o varias de las marcas descritas en Comentarios.

*dwPeriod*\
Tipo: DWORD

Cuando se redirige la salida, se procesa por lotes y se envía de vuelta al cliente periódicamente. Este valor especifica el número de milisegundos entre las operaciones de procesamiento por lotes.

*pCallback*\
Tipo: [IXtfRemoteRunCallback \*](https://docs.xbox.com/es/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)

Una devolución de llamada que se usa cuando se redirigen la entrada o la salida estándar.

### Valor devuelto

Tipo: HRESULT

Código de éxito o de error HRESULT.

## Comentarios

El parámetro dwFlags es una combinación AND bit a bit de cualquiera de los valores siguientes:

| Valor de marca | Efecto |
| - | - |
| XTFRUN\_WAIT | Espera a que se complete el comando. El comportamiento predeterminado es ejecutar el comando y devolver el control inmediatamente sin esperar a que se complete. |
| XTFRUN\_GUEST\_USER | Se ejecuta con la cuenta de usuario invitado. El comportamiento predeterminado es ejecutarse como usuario del sistema con privilegios elevados. |
| XTFRUN\_REDIRECT\_INPUT | Redirige la entrada estándar a través del pCallback especificado. Esto implica XTFRUN\_WAIT. |
| XTFRUN\_REDIRECT\_OUTPUT | Redirige la salida estándar a través del pCallback especificado. Esto implica XTFRUN\_WAIT. |
| XTFRUN\_REDIRECT\_BOTH | Redirige tanto la entrada estándar como la salida estándar a través del pCallback especificado. Esto implica XTFRUN\_WAIT. |

[IXtfRemoteRunCallback](https://docs.xbox.com/es/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md) contiene tanto una función de devolución de llamada de entrada como una de salida. Puede rellenar uno de estos miembros o ambos, tanto si necesita entrada *o* salida para una función como si necesita entrada *y* salida para una función.

Para obtener más información sobre la *entrada* de la devolución de llamada, consulte [IXtfRemoteRunCallback::Input](https://docs.xbox.com/es/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_input.md).

Para obtener más información sobre la *salida* de la devolución de llamada, consulte [IXtfRemoteRunCallback::Output](https://docs.xbox.com/es/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_output.md).

## Requisitos

**Encabezado:** xtfremoterun.h

**Biblioteca:** xtfremoterun.lib

**Plataformas compatibles:** Windows (para herramientas de consola XBOX)

## Consulte también

[XtfRemoteRun](https://docs.xbox.com/es/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)\
[IXtfRemoteRunClient](https://docs.xbox.com/es/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)\
[IXtfRemoteRunCallback](https://docs.xbox.com/es/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/es/reference/system/xasync/functions/xasyncrun.md)
- [Ejecutar (wdRun.exe)](https://docs.xbox.com/es/tools/tools-console/console_commandlinetools/wdrun.md)
- [XtfCreateRemoteRunClient](https://docs.xbox.com/es/reference/tools/xtf/xtfremoterun/methods/xtfremoterun_xtfcreateremoterunclient.md)
- [Interfaz IXtfRemoteRunCallback (contenido de la interfaz)](https://docs.xbox.com/es/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)