次の方法で共有

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 トピック)