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

# XtfGetOverlayFolder

> XtfGetOverlayFolder

# XtfGetOverlayFolder

특정 패키지 전체 이름과 연결된 오버레이 폴더 경로를 가져옵니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
HRESULT XtfGetOverlayFolder(
        PCWSTR address,
        PCWSTR packageFullName,
        PWSTR overlayFolderPath,
        UINT32* overlayFolderPathLength
)   
```

<a id="ID4ET" />

### 매개 변수

*address*<br />형식: PCWSTR

\[in] 콘솔 주소에 대한 포인터입니다.

*packageFullName*<br />형식: PCWSTR

\[in] 앱의 패키지 전체 이름에 대한 포인터입니다.

*overlayFolderPath*<br />형식: PWSTR

\[out, optional] 오버레이 폴더 경로입니다.

*overlayFolderPathLength*<br />형식: UINT32

\[in, out] WCHAR 단위의 overlayFolderPath 길이입니다.

<a id="ID4E1" />

### 반환값

형식: HRESULT

지정된 패키지 전체 이름에 대해 경로가 설정되어 있지 않으면 반환되는 overlayFolderPath 값은 **null**, overlayFolderPathLength는 0이고 **S\_OK**가 반환됩니다.

성공하면 **S\_OK**를 반환합니다. overlayFolderPath가 충분히 크지 않으면 \*\*HRESULT\_FROM\_WIN32(ERROR\_MORE\_DATA)\*\*를 반환하고, 필요한 버퍼 길이는 overlayFolderPathLength에 반환됩니다.

<a id="remarks" />

## 설명

[XTFSetOverlayFolder](/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m)를 사용하여 오버레이 폴더를 설정하거나 지웁니다. [XtfGetOverlayFolder](/reference/tools/xtf/xtfapi/functions/xtfgetoverlayfolder-xtfapi-xbox-windows-m)를 사용하여 패키지에 현재 설정된 오버레이 폴더 경로를 검색합니다. [XtfClearAllOverlayFolders](/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m)를 사용하여 이전에 콘솔에서 설정한 모든 오버레이 폴더를 지웁니다. [IXtfApplicationClient::GetInstalled](/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/getinstalled-ixtfapplicationclient-xtfapplication-xbox-microsoft-m)를 사용하여 콘솔에 현재 설치된 모든 패키지를 열거합니다.

## 요구 사항

**헤더:** xtfapi.h

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

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

## 참고 항목

[XTF Transport Errors (NDA topic)](/tools/tools-console/commandlinetools/xtf-transport-errors)<br />[Additional Xtf APIs](/reference/tools/xtf/xtfapi/atoc-xtfapi)<br />[Debugging with Overlay Folders (NDA topic)](/build/console-features/debugging-diagnostics/debugging-with-overlay-folders)<br />명령줄 도구 [xbapp overlayfolder (NDA topic)](/tools/tools-console/commandlinetools/xbapp)


## Related topics

- [XtfSetOverlayFolder](/ko/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m.md)
- [XtfClearAllOverlayFolders](/ko/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m.md)
- [XGameSaveFilesGetFolderWithUiAsync](/ko/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiasync.md)
- [XGameSaveFilesGetFolderWithUiResult](/ko/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiresult.md)
- [XBOX 타이틀을 위한 Title Performance Overlay](/ko/tools/tools-console/titleperfoverlay/index.md)