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
