跳轉到主要內容

XtfGetConsoleFieldValue

擷取主機的相關資訊,可以是 Tools IP Address、Console IP Address、AccessKey、Console ID、HostName、Device ID、DevKit Cert type、SystemMajorVersion、SystemMinorVersion、SystemBuildVersion 或 SystemRevisionVersion 其中之一。

語法

參數

hConsoleInfo
類型: XtfConsoleInfo
[in] XtfGetConsoleInfoList 所傳回的 XtfConsoleInfo 物件。 field
類型: XtfConsoleFieldId
[in] 要傳回之值的識別碼,可以是 Tools IP Address、Console IP Address、AccessKey、Console ID、HostName、Device ID、DevKit Cert type、SystemMajorVersion、SystemMinorVersion、SystemBuildVersion 或 SystemRevisionVersion 其中之一。 fieldType
類型: XtfConsoleFieldType *
[out] 傳回值的資料類型,可以是 UINT32 或 PWCHAR。 buffer
類型: BYTE *
[out] 接收傳回值之緩衝區的指標。若要判斷所需的緩衝區大小,請將此參數設為 nullptr,並將 cbBuffer 參數設為 0。函式傳回時,bufferSize 會設為所需緩衝區的大小 (以位元組為單位)。必要時,此大小會包含結束 null 字元的空間。 cbBuffer
類型: UINT32 *
[in, out] 輸入時為緩衝區的大小 (以位元組為單位)。如果傳回值為 PWCHAR,緩衝區大小必須包含結束 null 字元的空間。輸出時為所需的緩衝區長度 (以位元組為單位)。

傳回值

類型: HRESULT 傳回值 S_OK 表示函式成功,且 buffer 和 fieldType 包含值及值的類型。 傳回值 HRESULT_FROM_WIN32(ERROR_MORE_DATA) 表示為 buffer 引數提供的緩衝區不夠大。所需的緩衝區大小包含在 cbBuffer 中。 如果在未佈建的開發套件上無法使用該值 (例如 Device ID),傳回的 HRESULT 會是 0x80070490。 任何其他值都表示發生未預期的錯誤。

備註

使用 XtfGetConsoleInfoList 取得 XtfConsoleInfo 物件,然後使用 XtfGetConsoleFieldValue 從該物件擷取值。擷取所需的值之後,使用 XtfCloseConsoleInfoList 釋放與所傳回之 XtfConsoleInfo 物件相關聯的資源。
XtfGetConsoleInfoList 會從主機擷取所有資訊。XtfGetConsoleFieldValue 只會逐一查看該擷取的資訊。
如果目標主機尚未佈建,DeviceID 會傳回空值。

需求

標頭: xtfapi.h 程式庫: XtfApi.lib 支援的平台: Windows (適用於 XBOX 主機工具)

另請參閱

XTF 傳輸錯誤 (NDA 主題)
其他 Xtf API
最後修改於 2026年10月6日