Skip to main content

XtfCloseConsoleInfoList

Frees resources associated with an XtfConsoleInfo object returned by XtfGetConsoleInfoList.

Syntax

Parameters

hConsoleInfo
Type: XtfConsoleInfo
[in] XtfConsoleInfo object to free.

Return value

Type: HRESULT A return value of S_OK indicates the function succeeded. Any other value indicates an unexpected error occurred.

Remarks

Use XtfGetConsoleInfoList to get an XtfConsoleInfo object then use XtfGetConsoleFieldValue to retrieve the values from that object. When you have retrieved the values you needed, use XtfCloseConsoleInfoList to free resources associated with the returned XtfConsoleInfo object.
XtfGetConsoleInfoList retrieves all of the information from the console. XtfGetConsoleFieldValue simply iterates across that retrieved information.
If the target console has not been provisioned DeviceID will return an empty value.

Requirements

Header: xtfapi.h Library: XtfApi.lib Supported platforms: Windows (for XBOX console tools)

See also

XTF Transport Errors (NDA topic)
Additional Xtf APIs
Last modified on August 20, 2026