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

# XtfGetPackageFullName

> XtfGetPackageFullName

# XtfGetPackageFullName

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

<a id="syntaxSection" />

## 구문

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

<a id="parametersSection" />

### 매개 변수

*packageInfo*\
형식: XtfPackageInfo

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

*packageFullName*\
형식: PWSTR

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

*packageFullNameBufferLength*\
형식: UINT32 \*

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

### 반환값

형식: HRESULT

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

<a id="remarksSection" />

## 설명

이 함수는 등록된 패키지의 정보 개체에서 패키지 전체 이름을 가져오는 데 사용합니다. 패키지 정보 개체에 대한 포인터는 [XtfRegisterPackage](/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m) 또는 [XtfRegisterNetworkSharePackage](/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-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) 함수를 사용하여 등록된 패키지의 AUMID(Application User Model ID)를 검색할 수도 있습니다. 패키지에 대한 자세한 내용은 [Packaging](/build/core-features/common/packaging/gc-packaging-toc)을 참조하세요.

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

## 요구 사항

**헤더:** xtfapi.h

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

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

<a id="seealsoSection" />

## 참고 항목

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


## Related topics

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