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

# XtfRegisterPackage

> XtfRegisterPackage

# XtfRegisterPackage

타이틀 스크래치 드라이브에 배포된 패키지를 등록합니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
HRESULT XtfRegisterPackage(
         LPCWSTR address,
         LPCWSTR titleScratchRelativePath,
         XtfPackageInfo* packageInfo
)  
```

<a id="parametersSection" />

### 매개 변수

*address*\
형식: LPCWSTR

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

*titleScratchRelativePath*\
형식: LPCWSTR

\[in] 등록할 패키지의 타이틀 스크래치 드라이브 상대 경로입니다.

*packageInfo*\
형식: 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` 개체를 해제하세요.

[XtfUnregisterPackage](/reference/tools/xtf/xtfapi/functions/xtfunregisterpackage-xtfapi-xbox-windows-m)를 사용하여 패키지의 등록을 취소할 수도 있습니다. 애플리케이션 관리에 대한 자세한 내용은 [Application Management (xbapp.exe) (NDA topic)](/tools/tools-console/commandlinetools/xbapp)을 참조하세요.

<a id="requirementsSection" />

## 요구 사항

**헤더:** xtfapi.h

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

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

<a id="seealsoSection" />

## 참고 항목

[XTF Transport Errors (NDA topic)](/tools/tools-console/commandlinetools/xtf-transport-errors)\
[Additional Xtf APIs](/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [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)
- [XtfGetAumid](/ko/reference/tools/xtf/xtfapi/functions/xtfgetaumid-xtfapi-xbox-windows-m.md)
- [XtfGetCountofAppUserModelIds](/ko/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m.md)
- [XtfClosePackageInfo](/ko/reference/tools/xtf/xtfapi/functions/xtfclosepackageinfo-xtfapi-xbox-windows-m.md)