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

# XtfGetPackageFullName

> XtfGetPackageFullName

# XtfGetPackageFullName

패키지 정보 개체에서 패키지 전체 이름을 가져옵니다.

## 구문

```cpp theme={null}
HRESULT XtfGetPackageFullName(
         XtfPackageInfo packageInfo,
         PWSTR packageFullName,
         UINT32 *packageFullNameBufferLength
)  
```

### 매개 변수

*packageInfo*\
형식: XtfPackageInfo

\[in] 패키지의 정보 개체에 대한 포인터입니다.

*packageFullName*\
형식: PWSTR

\[out, optional] 패키지의 전체 이름입니다.

*packageFullNameBufferLength*\
형식: UINT32 \*

\[in, out] `packageFullName`에 할당된 길이(`WCHAR` 단위)입니다.

### 반환값

형식: HRESULT

성공하면 `S_OK`를 반환합니다. `packageFullName`이 충분히 크지 않은 경우 이 함수는 `HRESULT_FROM_WIN32(ERROR_MORE_DATA)`를 반환하고, 필요한 버퍼 길이는 `packageFullNameBufferLength`에 반환됩니다.

## 설명

이 함수는 등록된 패키지의 정보 개체에서 패키지 전체 이름을 가져오는 데 사용합니다. 패키지 정보 개체에 대한 포인터는 [XtfRegisterPackage](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m.md) 또는 [XtfRegisterNetworkSharePackage](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md) 함수를 호출하여 패키지를 등록하면 반환됩니다.

또한 [XtfGetCountofAppUserModelIds](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m.md) 및 [XtfGetAumid](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfgetaumid-xtfapi-xbox-windows-m.md) 함수를 사용하여 등록된 패키지의 AUMID(Application User Model ID)를 검색할 수도 있습니다. 패키지에 대한 자세한 내용은 [Packaging](https://docs.xbox.com/ko/build/core-features/common/packaging/gc-packaging-toc.md)을 참조하세요.

패키지 전체 이름은 [IXtfApplicationClient](https://docs.xbox.com/ko/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md) 인터페이스에 있는 플랫폼 수명 관리 작업에서 사용됩니다.

## 요구 사항

**헤더:** xtfapi.h

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

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

## 참고 항목

[XTF Transport Errors (NDA topic)](https://docs.xbox.com/ko/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[XtfRegisterPackage](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m.md)\
[XtfRegisterNetworkSharePackage](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md)\
[Additional Xtf APIs](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [XtfGetTitleOSState](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfgettitleosstate-xtfapi-xbox-windows-m.md)
- [XtfGetTitleOSFourPartVersion](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfgettitleosfourpartversion-xtfapi-xbox-windows-m.md)
- [XtfRegisterNetworkSharePackage](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md)
- [XtfRegisterPackage](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m.md)
- [XtfRegisterPackageOnDrive](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfregisterpackageondrive-xtfapi-xbox-windows-m.md)