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

# IXtfCopyFileCallback::OnEndFileCopy 方法

> IXtfCopyFileCallback::OnEndFileCopy 方法

# IXtfCopyFileCallback::OnEndFileCopy 方法

在開發主機上的兩個位置之間完成複製檔案時呼叫。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
public:
HRESULT OnEndFileCopy(
         LPCWSTR pszRootDirectory,
         LPCWSTR pszSearchPattern,
         LPCXTFFILEINFO pSrcFileInfo,
         LPCWSTR pszDstFileName,
         HRESULT hrErrorCode
)  
```

<a id="parametersSection" />

### 參數

*pszRootDirectory*\
類型：LPCWSTR

指向複製作業之根目錄路徑的指標。

*pszSearchPattern*\
類型：LPCWSTR

指向搜尋模式的指標，此模式定義要複製之來源檔案的檔案名稱。此參數接受萬用字元，以比對符合所指定模式的字串。

*pSrcFileInfo*\
類型：LPCXTFFILEINFO

指向 [XTFFILEINFO](/zh-TW/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t) 結構的指標，該結構包含所複製檔案的相關資訊。

*pszDstFileName*\
類型：LPCWSTR

指向目標檔案之檔案名稱的指標。

*hrErrorCode*\
類型：HRESULT

HRESULT 成功或錯誤碼。

<a id="retvalSection" />

### 傳回值

類型：HRESULT

如果成功，則傳回 `S_OK`；否則傳回 HRESULT 錯誤碼。

<a id="remarksSection" />

## 備註

[IXtfFileIOClient::CopyFiles](/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m) 函式會在檔案複製作業結束時呼叫此函式一次。回呼函式中指定的資訊包括 [XTFFILEINFO](/zh-TW/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t) 結構中傳輸的位元組總數。您可以檢查此函式的 `hrErrorCode` 參數，以識別檔案複製作業期間可能發生的任何錯誤。

<a id="requirementsSection" />

## 需求

**標頭：** xtffileio.h

**程式庫：** xtffileio.lib

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

<a id="seealsoSection" />

## 另請參閱

[IXtfCopyFileCallback 介面](/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t)\
[XtfFileIO](/zh-TW/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n)


## Related topics

- [IXtfCopyFileCallback::OnEndFileCopy Method](/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnEndFileCopy (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnEndFileCopy 메서드](/ko/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnFileCopyProgress Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnStartFileCopy Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)