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

# XtfRegisterPackageOnDrive

> XtfRegisterPackageOnDrive

# XtfRegisterPackageOnDrive

指定されたドライブにデプロイされたパッケージを登録します。

## Syntax

```cpp theme={null}
HRESULT XtfRegisterPackageOnDrive(
         LPCWSTR address,
         PCWSTR packageFullName,
         DWORD drive,
         XtfPackageInfo* packageInfo
)  
```

### Parameters

*address*\
型: LPCWSTR

\[in] コンソールのアドレスです。

*packageFullName*\
型: PCWSTR

\[in] 登録するパッケージのフル ネームです。

*drive*\
型: DWORD

\[in] パッケージを登録するドライブです。このパラメーターは次の値を受け付けます。

| Value | Description |
| - | - |
| 0 | リテール ドライブ |
| 1 | 開発ドライブ |
| 2 - 8 | 外部ドライブ 1 から外部ドライブ 7 |

*packageInfo*\
型: XtfPackageInfo\*

\[out] 登録されたパッケージに関するパッケージ情報オブジェクトです。

### Return value

型: HRESULT

成功した場合は `S_OK` を返します。それ以外の場合は、HRESULT エラー コードを返します。

## Remarks

この関数は、外部ドライブなどの指定されたドライブにデプロイされたパッケージを登録し、パッケージ情報を `XtfPackageInfo` オブジェクトの参照として提供します。登録されたパッケージのパッケージのフル ネームおよびアプリケーション ユーザー モデル ID (AUMID) を `XtfPackageInfo` オブジェクトから取得するには、[XtfGetPackageFullName](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md)、[XtfGetCountofAppUserModelIds](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m.md)、[XtfGetAumid](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfgetaumid-xtfapi-xbox-windows-m.md) 関数を使用します。`XtfPackageInfo` オブジェクトの使用が終わったら、[XtfClosePackageInfo](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfclosepackageinfo-xtfapi-xbox-windows-m.md) を使用して解放します。

アプリケーション管理の詳細については、[Application Management (xbapp.exe) (NDA topic)](https://docs.xbox.com/ja-jp/tools/tools-console/commandlinetools/xbapp.md) を参照してください。

## Requirements

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

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

**サポートされているプラットフォーム:** Windows (XBOX コンソール ツール用)

## See also

[Run from PC Deployment (NDA topic)](https://docs.xbox.com/ja-jp/home/setup-install/concepts/deployment.md)\
[XTF Transport Errors (NDA topic)](https://docs.xbox.com/ja-jp/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[Additional Xtf APIs](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [その他の Xtf API (API の内容)](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
- [XtfRegisterAllPackagesOnDrive](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfregisterallpackagesondrive-xtfapi-xbox-windows-m.md)
- [XtfRegisterPackage](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m.md)
- [XtfRegisterNetworkSharePackage](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md)
- [XtfGetPackageFullName](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md)