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

# XtfRegisterPackageOnDrive

> XtfRegisterPackageOnDrive

# XtfRegisterPackageOnDrive

지정한 드라이브에 배포된 패키지를 등록합니다.

<a id="syntaxSection" />

## 구문

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

<a id="parametersSection" />

### 매개 변수

*address*<br />형식: LPCWSTR

\[in] 콘솔의 주소입니다.

*packageFullName*<br />형식: PCWSTR

\[in] 등록할 패키지의 패키지 전체 이름입니다.

*drive*<br />형식: DWORD

\[in] 패키지를 등록할 드라이브입니다. 이 매개 변수는 다음 값을 허용합니다:

| 값     | 설명                      |
| ----- | ----------------------- |
| 0     | 정품 출시(Retail) 드라이브      |
| 1     | 개발용(Development) 드라이브   |
| 2 - 8 | 외장 드라이브 1부터 외장 드라이브 7까지 |

*packageInfo*<br />형식: XtfPackageInfo\*

\[out] 등록된 패키지에 대한 패키지 정보 개체입니다.

<a id="retvalSection" />

### 반환값

형식: HRESULT

성공하면 `S_OK`를 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

<a id="remarksSection" />

## 설명

이 함수는 지정한 드라이브(예: 외장 드라이브)에 배포된 패키지를 등록하고, 패키지 정보를 `XtfPackageInfo` 개체 참조로 제공합니다. [XtfGetPackageFullName](/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m), [XtfGetCountofAppUserModelIds](/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m), [XtfGetAumid](/reference/tools/xtf/xtfapi/functions/xtfgetaumid-xtfapi-xbox-windows-m) 함수를 사용하여 `XtfPackageInfo` 개체에서 등록된 패키지의 패키지 전체 이름과 AUMID(Application User Model ID)를 가져옵니다. 작업을 마쳤으면 [XtfClosePackageInfo](/reference/tools/xtf/xtfapi/functions/xtfclosepackageinfo-xtfapi-xbox-windows-m)를 사용하여 `XtfPackageInfo` 개체를 해제하세요.

애플리케이션 관리에 대한 자세한 내용은 [Application Management (xbapp.exe) (NDA topic)](/tools/tools-console/commandlinetools/xbapp)을 참조하세요.

<a id="requirementsSection" />

## 요구 사항

**헤더:** xtfapi.h

**라이브러리:** XtfApi.lib

**지원 플랫폼:** Windows(XBOX 콘솔 도구용)

<a id="seealsoSection" />

## 참고 항목

[Run from PC Deployment (NDA topic)](/home/setup-install/concepts/deployment)<br />[XTF Transport Errors (NDA topic)](/tools/tools-console/commandlinetools/xtf-transport-errors)<br />[Additional Xtf APIs](/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfRegisterAllPackagesOnDrive](/ko/reference/tools/xtf/xtfapi/functions/xtfregisterallpackagesondrive-xtfapi-xbox-windows-m.md)
- [XtfRegisterPackage](/ko/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m.md)
- [XtfRegisterNetworkSharePackage](/ko/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md)
- [XtfUnregisterPackage](/ko/reference/tools/xtf/xtfapi/functions/xtfunregisterpackage-xtfapi-xbox-windows-m.md)
- [XtfGetPackageFullName](/ko/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md)