Skip to main content

XtfGetOverlayFolder

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

구문

매개 변수

address
형식: PCWSTR
[in] 콘솔 주소에 대한 포인터입니다. packageFullName
형식: PCWSTR
[in] 앱의 패키지 전체 이름에 대한 포인터입니다. overlayFolderPath
형식: PWSTR
[out, optional] 오버레이 폴더 경로입니다. overlayFolderPathLength
형식: UINT32
[in, out] WCHAR 단위의 overlayFolderPath 길이입니다.

반환값

형식: HRESULT 지정된 패키지 전체 이름에 대해 경로가 설정되어 있지 않으면 반환되는 overlayFolderPath 값은 null, overlayFolderPathLength는 0이고 S_OK가 반환됩니다. 성공하면 S_OK를 반환합니다. overlayFolderPath가 충분히 크지 않으면 **HRESULT_FROM_WIN32(ERROR_MORE_DATA)**를 반환하고, 필요한 버퍼 길이는 overlayFolderPathLength에 반환됩니다.

설명

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

요구 사항

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

참고 항목

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