XtfGetConsoleFieldValue
Recupera información sobre una consola: Tools IP Address, Console IP Address, AccessKey, Console ID, HostName, Device ID, DevKit Cert type, SystemMajorVersion, SystemMinorVersion, SystemBuildVersion o SystemRevisionVersion.Sintaxis
Parámetros
hConsoleInfoTipo: XtfConsoleInfo [in] Objeto XtfConsoleInfo devuelto por XtfGetConsoleInfoList. field
Tipo: XtfConsoleFieldId [in] Identificador del valor que se va a devolver: Tools IP Address, Console IP Address, AccessKey, Console ID, HostName, Device ID, DevKit Cert type, SystemMajorVersion, SystemMinorVersion, SystemBuildVersion o SystemRevisionVersion. fieldType
Tipo: XtfConsoleFieldType * [out] El tipo de datos del valor devuelto: UINT32 o PWCHAR. buffer
Tipo: BYTE * [out] Un puntero al búfer que recibe el valor devuelto. Para determinar el tamaño de búfer necesario, establezca este parámetro en nullptr y el parámetro cbBuffer en 0. Cuando la función devuelva el control, bufferSize se establecerá en el tamaño del búfer necesario en bytes. Este tamaño incluirá espacio para el carácter nulo de terminación si es necesario. cbBuffer
Tipo: UINT32 * [in, out] En la entrada, el tamaño del búfer en bytes. El tamaño del búfer debe incluir espacio para un carácter nulo de terminación si el valor devuelto es un PWCHAR. En la salida, la longitud necesaria del búfer en bytes.
Valor devuelto
Tipo: HRESULT Un valor devuelto de S_OK indica que la función se completó correctamente y que buffer y fieldType contienen el valor y el tipo del valor. Un valor devuelto de HRESULT_FROM_WIN32(ERROR_MORE_DATA) indica que el búfer proporcionado para el argumento buffer no era lo suficientemente grande. El tamaño de búfer necesario se encuentra en cbBuffer. Si el valor no está disponible (por ejemplo, Device ID) en un kit de desarrollo sin aprovisionar, el HRESULT devuelto será 0x80070490. Cualquier otro valor indica que se produjo un error inesperado.Comentarios
Use XtfGetConsoleInfoList para obtener un objeto XtfConsoleInfo y, después, use XtfGetConsoleFieldValue para recuperar los valores de ese objeto. Cuando haya recuperado los valores que necesitaba, use XtfCloseConsoleInfoList para liberar los recursos asociados al objeto XtfConsoleInfo devuelto.XtfGetConsoleInfoList recupera toda la información de la consola. XtfGetConsoleFieldValue simplemente recorre esa información recuperada.
Si la consola de destino no se ha aprovisionado, DeviceID devolverá un valor vacío.
Requisitos
Encabezado: xtfapi.h Biblioteca: XtfApi.lib Plataformas compatibles: Windows (para herramientas de consola XBOX)Consulte también
Errores de transporte de XTF (tema con NDA)API de Xtf adicionales
