다음을 통해 공유

XtfGetOverlayFolder

  • 아티클

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

구문

HRESULT XtfGetOverlayFolder(
        PCWSTR address,
        PCWSTR packageFullName,
        PWSTR overlayFolderPath,
        UINT32* overlayFolderPathLength
)

매개 변수

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 전송 오류(NDA 항목)
추가 Xtf API
오버레이 폴더를 사용한 디버깅(NDA 항목)
명령줄 도구 xbapp overlayfolder (NDA 항목)