다음을 통해 공유

XtfSetOverlayFolder

  • 아티클

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

구문

HRESULT XtfSetOverlayFolder(
        PCWSTR address,
        PCWSTR packageFullName,
        PCWSTR overlayFolderPath
)

매개 변수

address
형식: PCWSTR

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

packageFullName
형식: PCWSTR

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

overlayFolderPath
형식: PCWSTR

[in] 오버레이 폴더 경로를 포함하는 문자열에 대한 포인터입니다. overlayFolderPath가 null이면 packageFullName이 무시되고 오버레이 폴더가 재설정됩니다(xbapp overlayfolder package_full_name /r (NDA 항목)과 동일).

반환 값

형식: HRESULT

반환 값 S_OK는 함수가 성공했음을 나타냅니다. 다른 모든 값은 예상치 않은 오류가 발생했음을 나타냅니다.

비고

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

참고 항목

XtfSetOverlayFolder를 사용하여 설정된 오버레이 폴더는 콘솔을 재부팅해도 유지됩니다.

C++ 예시

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 콘솔 도구용)

참고 항목

오버레이 폴더를 사용한 디버깅(NDA 항목)
명령줄 도구 xbapp overlayfolder (NDA 항목)
XTF 전송 오류(NDA 항목)