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

# XtfCreateRemoteRunClient 方法

> XtfCreateRemoteRunClient 方法

# XtfCreateRemoteRunClient 方法

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

<a id="syntaxSection" />

## 語法

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

<a id="ID4EG" />

<a id="parametersSection" />

### 參數

*pszAddress*\
類型：LPCWSTR

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

*riid*\
類型：REFIID

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

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

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

<a id="ID4EN" />

<a id="retvalSection" />

### 傳回值

類型：HRESULT

作業的結果。

<a id="remarksSection" />

## 備註

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

<a id="requirements" />

## 需求

**標頭：** xtfremoterun.h

**程式庫：** xtfremoterun.lib

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

## 另請參閱

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


## Related topics

- [IXtfRemoteRunClient 介面](/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/interfaces/ixtfremoterunclient.md)
- [IXtfRemoteRunClient::Run 方法](/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunClient/methods/ixtfremoterunclient_run.md)
- [IXtfRemoteRunCallback::Input 方法](/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_input.md)
- [IXtfRemoteRunCallback::Output 方法](/zh-TW/reference/tools/xtf/xtfremoterun/classes/IXtfRemoteRunCallback/methods/ixtfremoteruncallback_output.md)
- [IXtfFileIOClient::CreateDirectory 方法](/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/createdirectory-ixtffileioclient-xtffileio-xbox-microsoft-m.md)