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

# XtfCreateRemoteRunClient

> XtfCreateRemoteRunClient 方法

# XtfCreateRemoteRunClient 方法

使用指定的位址初始化 IXtfRemoteRunClient 介面的新執行個體。

## 語法

```cpp theme={null}
HRESULT XtfCreateRemoteRunClient(
         LPCWSTR pszAddress,
         REFIID riid,
         void **ppvObject
)  
```

### 參數

*pszAddress*\
類型：LPCWSTR

指向新 [IXtfRemoteRunClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md) 所要使用之開發主機工具 IP 位址的指標。

*riid*\
類型：REFIID

接收新建立之 [IXtfRemoteRunClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md) 執行個體識別碼的指標。

*ppvObject*\
類型：void \*\*

接收新建立之 [IXtfRemoteRunClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md) 參考的指標。

### 傳回值

類型：HRESULT

作業的結果。

## 備註

[遠端執行用戶端](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)是會在您的主機上呼叫可執行檔的類別。\
此類別可用來執行各種可執行檔，從測試工具到常見的命令列指令 (例如 *kill process*)。
建立執行用戶端之後，您可以使用其 [Run](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/methods/ixtfremoterunclient_run.md) 函式來執行可執行檔。
若要執行需要輸入或輸出的可執行檔，您必須使用 [IXtfRemoteRunCallback 介面](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)作為 [Run](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/methods/ixtfremoterunclient_run.md) 函式的參數。

## 需求

**標頭：** xtfremoterun.h

**程式庫：** xtfremoterun.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

## 另請參閱

[IXtfRemoteRunClient](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)\
[IXtfRemoteRunClient::Run](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/methods/ixtfremoterunclient_run.md)\
[IXtfRemoteRunCallback 介面](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)


## Related topics

- [XtfRemoteRun 成員 (API 內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfremoterun/xtfremoterun_members.md)
- [IXtfRemoteRunClient 介面 (介面內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)
- [Run](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/methods/ixtfremoterunclient_run.md)
- [IXtfRemoteRunCallback 介面 (介面內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/interfaces/ixtfremoteruncallback.md)
- [Input](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_input.md)