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

# XtfSetOverlayFolder

> XtfSetOverlayFolder

# XtfSetOverlayFolder

특정 패키지 전체 이름과 연결된 오버레이 폴더 값을 설정하거나 재설정합니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
HRESULT XtfSetOverlayFolder(
        PCWSTR address,
        PCWSTR packageFullName,
        PCWSTR overlayFolderPath
)   
```

<a id="ID4ET" />

### 매개 변수

*address*<br />형식: PCWSTR

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

*packageFullName*<br />형식: PCWSTR

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

*overlayFolderPath*<br />형식: PCWSTR

\[in] 오버레이 폴더 경로를 포함하는 문자열에 대한 포인터입니다. overlayFolderPath가 **null**이면 packageFullName은 무시되고 오버레이 폴더가 재설정됩니다([xbapp overlayfolder package\_full\_name /r (NDA topic)](/tools/tools-console/commandlinetools/xbapp)와 동일).

<a id="ID4E1" />

### 반환값

형식: HRESULT

반환값이 **S\_OK**이면 함수가 성공했음을 나타냅니다. 다른 값은 예기치 않은 오류가 발생했음을 나타냅니다.

<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)를 사용하여 콘솔에 현재 설치된 모든 패키지를 열거합니다.

<Note>
  XtfSetOverlayFolder를 사용하여 설정된 오버레이 폴더는 콘솔 재부팅 후에도 유지됩니다.
</Note>

<a id="ID4E6C" />

## C++ 예제

```cpp theme={null}
int wmain(int argc, wchar_t **argv)
{
    HRESULT             hr = S_OK;
    PCWSTR              consoleAddress = L"190.167.10.18";
    PCWSTR              pOverlayFolderPFN = L"682716bc-bcec-4d5b-a21d-e2b6a4e3066d_1.0.0.0_x64__8wekyb3d8bbwe";
    PWSTR               pOverlayFolderPath = L"D:\\MyGame1\\";
    PWSTR               pOverlayFolderPathReturned = nullptr;
    UINT32              bufferSize = 0;

    hr = XtfSetOverlayFolder(consoleAddress, pOverlayFolderPFN, pOverlayFolderPath);
    if (FAILED(hr))
    {
        wprintf(L"\n\n*** XtfSetOverlayFolder failed 0x%x", hr);
        return hr;
    }

    pOverlayFolderPathReturned = new WCHAR[APPLICATION_USER_MODEL_ID_MAX_LENGTH];
    hr = XtfGetOverlayFolder(consoleAddress, pOverlayFolderPFN, pOverlayFolderPathReturned, &buffersize);
    if (FAILED(hr))
    {
        wprintf(L"\n\n*** Overlay Folder Path is set to %s", pOverlayFolderPathReturned);
    }
    else
    {
        wprintf(L"\n\n*** XtfGetOverlayFolder failed 0x%x", hr);
    }
    delete[] pOverlayFolderPathReturned;

    return hr;
}
```

## 요구 사항

**헤더:** xtfapi.h

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

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

## 참고 항목

[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)<br />[XTF Transport Errors (NDA topic)](/tools/tools-console/commandlinetools/xtf-transport-errors)


## Related topics

- [XtfGetOverlayFolder](/ko/reference/tools/xtf/xtfapi/functions/xtfgetoverlayfolder-xtfapi-xbox-windows-m.md)
- [XtfClearAllOverlayFolders](/ko/reference/tools/xtf/xtfapi/functions/xtfclearalloverlayfolders-xtfapi-xbox-windows-m.md)
- [XBOX 타이틀을 위한 Title Performance Overlay](/ko/tools/tools-console/titleperfoverlay/index.md)
- [오버레이 폴더 관리](/ko/tools/tools-console/wdp/windows-device-portal-on-xbox-overlay-folders.md)
- [IXtfApplicationClient::SetDefaultApp](/ko/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/setdefaultapp-ixtfapplicationclient-xtfapplication-xbox-wi.md)