XtfGetConsoleInfoList
傳回包含主機相關資訊的XtfConsoleInfo 物件。
語法
參數
address類型:PCWSTR [in] 主機的位址。 hConsoleInfo
類型:XtfConsoleInfo* [out] 與 XtfGetConsoleFieldValue 函式搭配使用以擷取主機相關資訊的指標。
傳回值
類型:HRESULT 如果函式成功,且可以使用 XtfGetConsoleFieldValue 從 hConsoleInfo 擷取值,則傳回S_OK;否則傳回 HRESULT 錯誤碼。
備註
若要擷取主機的相關資訊,請先使用此函式取得XtfConsoleInfo 指標,然後使用 XtfGetConsoleFieldValue 從該指標擷取主機的相關資訊。擷取所需的資訊之後,請使用 XtfCloseConsoleInfoList 釋放與傳回之 XtfConsoleInfo 指標相關聯的資源。
XtfGetConsoleInfoList 會從主機擷取所有資訊,並提供指向該資訊的指標。XtfGetConsoleFieldValue 只會逐一查看所擷取的資訊。您必須同時使用這兩個函式,才能擷取主機的相關資訊。如果在此函式的
address 中指定的目標主機尚未佈建,則當 field 中指定 XtfConsoleFieldId::DeviceID 時,XtfGetConsoleFieldValue 函式會傳回空值。XtfGetConsoleInfoList 與 XtfGetConsoleFieldValue 函式來擷取開發主機的主機識別碼。
需求
標頭: xtfapi.h 程式庫: XtfApi.lib 支援的平台: Windows (適用於 XBOX 主機工具)另請參閱
XtfConsoleControlXBOX Tools Framework
