XtfCloseConsoleInfoList

XtfGetConsoleInfoList によって返される XtfConsoleInfo オブジェクトに関連付けられたリソースを解放します。

構文

HRESULT XtfCloseConsoleInfoList(
         XtfConsoleInfo hConsoleInfo
)  

パラメーター

hConsoleInfo
型: XtfConsoleInfo

[in] 解放する XtfConsoleInfo オブジェクト。

戻り値

型: HRESULT

戻り値の S_OK は、関数が成功したことを示します。 その他の値は、予期しないエラーが発生したことを示します。

解説

XtfGetConsoleInfoList を使用して XtfConsoleInfo オブジェクトを取得した後、XtfGetConsoleFieldValue を使用してそのオブジェクトから値を取得します。 必要な値を取得したら、XtfCloseConsoleInfoList を使用して、返された XtfConsoleInfo オブジェクトと関連付けられているリソースを解放します。

注意

XtfGetConsoleInfoList は本体からすべての情報を取得します。 XtfGetConsoleFieldValue は取得した情報を単に反復処理します。

注意

ターゲット本体が準備されていない場合、DeviceID は空の値を返します。

int wmain(int argc, wchar_t **argv)
{
  HRESULT             hr             = S_OK;
  PCWSTR              consoleAddress = L" 190.167.10.18";
  XtfConsoleInfo      hConsoleInfo   = nullptr;
  XtfConsoleFieldType fieldType      = XtfConsoleFieldType::FieldTypeUINT32;
  BYTE *              pValueBuffer   = nullptr;
  UINT32              bufferSize     = 0;

  hr = XtfGetConsoleInfoList(consoleAddress, &hConsoleInfo);
  if (FAILED(hr))
  {
    wprintf(L"\n\n*** XtfGetConsoleInfoList failed 0x%x", hr);
    return hr;
  }

  hr = XtfGetConsoleFieldValue(hConsoleInfo, XtfConsoleFieldId::ConsoleId, &fieldType, nullptr, &bufferSize);
  if (hr != HRESULT_FROM_WIN32(ERROR_MORE_DATA))
  {
    XtfCloseConsoleInfoList(hConsoleInfo);
    wprintf(L"\n\n*** XtfGetConsoleFieldValue failed 0x%x", hr);
    return hr;
  }

  pValueBuffer = new BYTE[bufferSize];

  hr  = XtfGetConsoleFieldValue(hConsoleInfo, XtfConsoleFieldId::ConsoleId, &fieldType, pValueBuffer, &bufferSize);
  if (SUCCEEDED(hr))
  {
    PWCHAR consoleId = (PWCHAR)pValueBuffer;
    wprintf(L"\n\n*** Console ID is %s", consoleId);
  }
  else
  {
    wprintf(L"\n\n*** XtfGetConsoleFieldValue failed 0x%x", hr);
  }

  XtfCloseConsoleInfoList(hConsoleInfo);
  delete[] pValueBuffer;

  return hr;
}  

要件

ヘッダー: xtfapi.h

ライブラリ: XtfApi.lib

サポートされているプラットフォーム: Windows (Xbox 本体ツール用)

関連項目

XTF トランスポート エラー (NDA トピック)認可が必須です
その他の Xtf API