Skip to main content

XtfSetOverlayFolder

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

구문

매개 변수

address
형식: PCWSTR
[in] 콘솔 주소에 대한 포인터입니다. packageFullName
형식: PCWSTR
[in] 앱의 패키지 전체 이름에 대한 포인터입니다. overlayFolderPath
형식: PCWSTR
[in] 오버레이 폴더 경로를 포함하는 문자열에 대한 포인터입니다. overlayFolderPath가 null이면 packageFullName은 무시되고 오버레이 폴더가 재설정됩니다(xbapp overlayfolder package_full_name /r (NDA topic)와 동일).

반환값

형식: HRESULT 반환값이 S_OK이면 함수가 성공했음을 나타냅니다. 다른 값은 예기치 않은 오류가 발생했음을 나타냅니다.

설명

XTFSetOverlayFolder를 사용하여 오버레이 폴더를 설정하거나 지웁니다. XtfGetOverlayFolder를 사용하여 패키지에 현재 설정된 오버레이 폴더 경로를 검색합니다. XtfClearAllOverlayFolders를 사용하여 이전에 콘솔에서 설정한 모든 오버레이 폴더를 지웁니다. IXtfApplicationClient::GetInstalled를 사용하여 콘솔에 현재 설치된 모든 패키지를 열거합니다.
XtfSetOverlayFolder를 사용하여 설정된 오버레이 폴더는 콘솔 재부팅 후에도 유지됩니다.

C++ 예제

요구 사항

헤더: xtfapi.h 라이브러리: XtfApi.lib 지원 플랫폼: Windows(XBOX 콘솔 도구용)

참고 항목

Debugging with Overlay Folders (NDA topic)
명령줄 도구 xbapp overlayfolder (NDA topic)
XTF Transport Errors (NDA topic)
마지막 수정일 2026년 8월 24일