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

# XtfRegisterAllPackagesOnDrive

> XtfRegisterAllPackagesOnDrive

# XtfRegisterAllPackagesOnDrive

註冊部署在指定磁碟機上的所有套件。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
HRESULT XtfRegisterAllPackagesOnDrive(
         LPCWSTR address,
         DWORD drive,
         LPBSTR pbstrPackageList
)  
```

<a id="parametersSection" />

### 參數

*address*<br />類型：LPCWSTR

\[in] 主機的位址。

*drive*<br />類型：DWORD

\[in] 要在其上註冊套件的磁碟機。此參數接受下列值：

| 值 | 描述 |
| - | - |
| 0 | 零售磁碟機 |
| 1 | 開發磁碟機 |
| 2 - 8 | 外部磁碟機 1 到外部磁碟機 7 |

*pbstrPackageList*<br />類型：LPBSTR

\[out] 已註冊之套件和應用程式的相關資訊。

<a id="retvalSection" />

### 傳回值

類型：HRESULT

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

<a id="remarksSection" />

## 備註

此函式會註冊部署在指定磁碟機 (例如外部磁碟機) 上的所有套件，並在 *pbstrPackageList* 中提供字串化的 JSON 物件。此 JSON 物件是一個陣列，會提供每個已註冊套件的套件完整名稱和應用程式，包括應用程式使用者模型識別碼 (AUMID)。

如需管理應用程式的詳細資訊，請參閱[應用程式管理 (xbapp.exe) (NDA 主題)](/zh-TW/tools/tools-console/commandlinetools/xbapp)。

<a id="requirementsSection" />

## 需求

**標頭：** xtfapi.h

**程式庫：** XtfApi.lib

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

<a id="seealsoSection" />

## 另請參閱

[從 PC 執行部署 (NDA 主題)](/zh-TW/home/setup-install/concepts/deployment)<br />[XTF 傳輸錯誤 (NDA 主題)](/zh-TW/tools/tools-console/commandlinetools/xtf-transport-errors)<br />[其他 Xtf API](/zh-TW/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfRegisterPackageOnDrive](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfregisterpackageondrive-xtfapi-xbox-windows-m.md)
- [XtfRegisterPackage](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m.md)
- [XtfRegisterNetworkSharePackage](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md)
- [XtfUnregisterPackage](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfunregisterpackage-xtfapi-xbox-windows-m.md)
- [XtfGetPackageFullName](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md)