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

# Méthode IXtfRemoteRunClient::Run

Exécute une commande donnée sur la console.

## Syntaxe

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

### Paramètres

*pszCommandLine*\
Type : LPCWSTR

Ligne de commande à exécuter sur la console distante.

*pszWorkingDirectory*\
Type : LPCWSTR

Répertoire de travail sur la console distante.

*dwFlags*\
Type : DWORD

Un ou plusieurs des indicateurs décrits dans la section Remarques.

*dwPeriod*\
Type : DWORD

Lorsque la sortie est redirigée, elle est regroupée par lots et renvoyée périodiquement au client. Cette valeur spécifie le nombre de millisecondes entre les opérations de regroupement.

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

Rappel utilisé lorsque l'entrée ou la sortie standard est redirigée.

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

## Remarques

Le paramètre dwFlags est un AND au niveau du bit de l'une des valeurs suivantes :

| Valeur d'indicateur | Effet |
| - | - |
| XTFRUN\_WAIT | Attend la fin de la commande. Le comportement par défaut consiste à exécuter la commande et à retourner immédiatement sans attendre la fin. |
| XTFRUN\_GUEST\_USER | Exécute sous le compte d'utilisateur invité. Le comportement par défaut consiste à exécuter en tant qu'utilisateur système avec privilèges élevés. |
| XTFRUN\_REDIRECT\_INPUT | Redirige l'entrée standard via le pCallback donné. Implique XTFRUN\_WAIT. |
| XTFRUN\_REDIRECT\_OUTPUT | Redirige la sortie standard via le pCallback donné. Implique XTFRUN\_WAIT. |
| XTFRUN\_REDIRECT\_BOTH | Redirige à la fois l'entrée standard et la sortie standard via le pCallback donné. Implique XTFRUN\_WAIT. |

[IXtfRemoteRunCallback](https://docs.xbox.com/fr/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md) contient à la fois une fonction de rappel d'entrée et une fonction de rappel de sortie. Vous pouvez renseigner l'un de ces membres ou les deux, selon que vous avez besoin d'une entrée *ou* d'une sortie pour une fonction, ou d'une entrée *et* d'une sortie pour une fonction.

Pour plus d'informations sur l'*entrée* du rappel, consultez [IXtfRemoteRunCallback::Input](https://docs.xbox.com/fr/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_input.md).

Pour plus d'informations sur la *sortie* du rappel, consultez [IXtfRemoteRunCallback::Output](https://docs.xbox.com/fr/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_output.md).

## Configuration requise

**En-tête :** xtfremoterun.h

**Bibliothèque :** xtfremoterun.lib

**Plateformes prises en charge :** Windows (pour les outils de console XBOX)

## Voir aussi

[XtfRemoteRun](https://docs.xbox.com/fr/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)\
[IXtfRemoteRunClient](https://docs.xbox.com/fr/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)\
[IXtfRemoteRunCallback](https://docs.xbox.com/fr/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/fr/reference/system/xasync/functions/xasyncrun.md)
- [Exécution (wdRun.exe)](https://docs.xbox.com/fr/tools/tools-console/console_commandlinetools/wdrun.md)
- [XtfCreateRemoteRunClient](https://docs.xbox.com/fr/reference/tools/xtf/xtfremoterun/methods/xtfremoterun_xtfcreateremoterunclient.md)
- [Interface IXtfRemoteRunCallback (contenu de l'interface)](https://docs.xbox.com/fr/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)