> ## 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 メソッド

# IXtfRemoteRunClient::Run メソッド

コンソール上で指定されたコマンドを実行します。

## 構文

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

### パラメーター

*pszCommandLine*\
型: LPCWSTR

リモート コンソール上で実行するコマンド ライン。

*pszWorkingDirectory*\
型: LPCWSTR

リモート コンソール上の作業ディレクトリ。

*dwFlags*\
型: DWORD

解説に記載されているフラグのうち 1 つ以上。

*dwPeriod*\
型: DWORD

出力がリダイレクトされる場合、バッチ処理されて定期的にクライアントに送り返されます。この値は、バッチ処理操作間のミリ秒数を指定します。

*pCallback*\
型: [IXtfRemoteRunCallback \*](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)

標準入力または標準出力がリダイレクトされるときに使用されるコールバック。

### 戻り値

型: HRESULT

HRESULT の成功またはエラー コード。

## 解説

dwFlags パラメーターは、次の値のいずれかのビット単位 AND の組み合わせです。

| フラグ値 | 効果 |
| - | - |
| XTFRUN\_WAIT | コマンドが完了するまで待機します。既定の動作では、コマンドを実行して完了を待たずにすぐに戻ります。 |
| XTFRUN\_GUEST\_USER | ゲスト ユーザー アカウントで実行します。既定の動作では、昇格されたシステム ユーザーとして実行します。 |
| XTFRUN\_REDIRECT\_INPUT | 指定した pCallback を通じて標準入力をリダイレクトします。これは XTFRUN\_WAIT を暗黙的に指定します。 |
| XTFRUN\_REDIRECT\_OUTPUT | 指定した pCallback を通じて標準出力をリダイレクトします。これは XTFRUN\_WAIT を暗黙的に指定します。 |
| XTFRUN\_REDIRECT\_BOTH | 指定した pCallback を通じて標準入力と標準出力の両方をリダイレクトします。これは XTFRUN\_WAIT を暗黙的に指定します。 |

[IXtfRemoteRunCallback](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md) には、入力コールバック関数と出力コールバック関数の両方が含まれています。関数に入力*または*出力が必要な場合、あるいは関数に入力*と*出力の両方が必要な場合、これらのメンバーのいずれかまたは両方に値を設定できます。

コールバックの*入力*に関する詳細については、[IXtfRemoteRunCallback::Input](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_input.md) を参照してください。

コールバックの*出力*に関する詳細については、[IXtfRemoteRunCallback::Output](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_output.md) を参照してください。

## 要件

**ヘッダー:** xtfremoterun.h

**ライブラリ:** xtfremoterun.lib

**対応プラットフォーム:** Windows (XBOX コンソール ツール用)

## 関連項目

[XtfRemoteRun](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)\
[IXtfRemoteRunClient](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)\
[IXtfRemoteRunCallback](https://docs.xbox.com/ja-jp/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/ja-jp/reference/system/xasync/functions/xasyncrun.md)
- [実行 (wdRun.exe)](https://docs.xbox.com/ja-jp/tools/tools-console/console_commandlinetools/wdrun.md)
- [XtfCreateRemoteRunClient](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfremoterun/methods/xtfremoterun_xtfcreateremoterunclient.md)
- [XtfRemoteRun メンバー (API の目次)](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfremoterun/xtfremoterun_members.md)