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