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

# IXtfRemoteRunClient::Run (método)

> IXtfRemoteRunClient::Run (método)

# IXtfRemoteRunClient::Run (método)

Ejecuta un comando determinado en la consola.

<a id="syntaxSection" />

## Sintaxis

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

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 \*](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback)

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

<a id="ID4EP" />

<a id="retvalSection" />

### Valor devuelto

Tipo: HRESULT

Código de éxito o de error HRESULT.

<a id="remarks" />

## 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](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback) 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](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_input).

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

<a id="requirements" />

## Requisitos

**Encabezado:** xtfremoterun.h

**Biblioteca:** xtfremoterun.lib

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

## Consulte también

[XtfRemoteRun](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient)\
[IXtfRemoteRunClient](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient)\
[IXtfRemoteRunCallback](/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback)


## Related topics

- [IXtfRemoteRunClient (interfaz)](/es/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)
- [Método XtfCreateRemoteRunClient](/es/reference/tools/xtf/xtfremoterun/methods/xtfremoterun_xtfcreateremoterunclient.md)
- [IXtfRemoteRunCallback::Input (método)](/es/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_input.md)
- [IXtfRemoteRunCallback::Output (método)](/es/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_output.md)
- [IXtfRemoteRunCallback (interfaz)](/es/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)