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

> Méthode IXtfRemoteRunClient::Run

# Méthode IXtfRemoteRunClient::Run

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

<a id="syntaxSection" />

## Syntaxe

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

<a id="ID4EG" />

<a id="parametersSection" />

### Paramètres

*pszCommandLine*\
Type : LPCWSTR

La ligne de commande à exécuter sur la console distante.

*pszWorkingDirectory*\
Type : LPCWSTR

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

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

<a id="ID4EP" />

<a id="retvalSection" />

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

<a id="remarks" />

## Remarques

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

| Valeur de l'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 sa 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 par l'intermédiaire du pCallback donné. Cela implique XTFRUN\_WAIT. |
| XTFRUN\_REDIRECT\_OUTPUT | Redirige la sortie standard par l'intermédiaire du pCallback donné. Cela implique XTFRUN\_WAIT. |
| XTFRUN\_REDIRECT\_BOTH | Redirige à la fois l'entrée standard et la sortie standard par l'intermédiaire du pCallback donné. Cela implique XTFRUN\_WAIT. |

[IXtfRemoteRunCallback](/fr-CA/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback) contient à la fois une fonction de rappel d'entrée et une fonction de rappel de sortie. Vous pouvez renseigner l'un ou l'autre 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* de rappel, consultez [IXtfRemoteRunCallback::Input](/fr-CA/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_input).

Pour plus d'informations sur la *sortie* de rappel, consultez [IXtfRemoteRunCallback::Output](/fr-CA/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_output).

<a id="requirements" />

## 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](/fr-CA/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient)\
[IXtfRemoteRunClient](/fr-CA/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient)\
[IXtfRemoteRunCallback](/fr-CA/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback)


## Related topics

- [Interface IXtfRemoteRunClient](/fr-CA/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)
- [Méthode XtfCreateRemoteRunClient](/fr-CA/reference/tools/xtf/xtfremoterun/methods/xtfremoterun_xtfcreateremoterunclient.md)
- [Méthode IXtfRemoteRunCallback::Input](/fr-CA/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_input.md)
- [Méthode IXtfRemoteRunCallback::Output](/fr-CA/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_output.md)
- [Interface IXtfRemoteRunCallback](/fr-CA/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)