DeviceInformation.CreateFromIdAsync Método

Definición

Sobrecargas

CreateFromIdAsync(String)

Crea un objeto DeviceInformation a partir de un identificador deviceInformation .

CreateFromIdAsync(String, IIterable<String>)

Crea un objeto DeviceInformation a partir de un identificador deviceInformation y una lista de propiedades adicionales.

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

Crea un objeto DeviceInformation a partir de un identificador deviceInformation , una lista de propiedades adicionales y un parámetro DeviceInformationKind .

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings)

Crea de forma asincrónica un objeto DeviceInformation a partir de un identificador deviceInformation , una lista de propiedades adicionales, un DeviceInformationKind y un objeto de configuración.

CreateFromIdAsync(String)

Crea un objeto DeviceInformation a partir de un identificador deviceInformation .

public:
 static IAsyncOperation<DeviceInformation ^> ^ CreateFromIdAsync(Platform::String ^ deviceId);
/// [Windows.Foundation.Metadata.Overload("CreateFromIdAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<DeviceInformation> CreateFromIdAsync(winrt::hstring const& deviceId);
[Windows.Foundation.Metadata.Overload("CreateFromIdAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<DeviceInformation> CreateFromIdAsync(string deviceId);
function createFromIdAsync(deviceId)
Public Shared Function CreateFromIdAsync (deviceId As String) As IAsyncOperation(Of DeviceInformation)

Parámetros

deviceId
String

Platform::String

winrt::hstring

El identificador del dispositivo.

Devoluciones

Objeto para iniciar y administrar la creación asincrónica del objeto DeviceInformation .

Atributos

Ejemplos

La variable savedId de este ejemplo es un identificador deviceInformation guardado anteriormente por la aplicación, obtenido de la propiedad id del objeto DeviceInformation usado por última vez.

// Create a DeviceInformation object from a saved ID
var Enum = Windows.Devices.Enumeration;
var DevInf = Enum.DeviceInformation;
DevInf.createFromIdAsync(savedId).then(
    function(devinfo) {
        // Use the created DeviceInformation object
        printMessage("Created DeviceInformation. Name: " + devinfo.name);
    },
    function (e) {
        displayError("Failed to create DeviceInformation: " + e.message);
    });

Consulte también

Se aplica a

CreateFromIdAsync(String, IIterable<String>)

Crea un objeto DeviceInformation a partir de un identificador deviceInformation y una lista de propiedades adicionales.

public:
 static IAsyncOperation<DeviceInformation ^> ^ CreateFromIdAsync(Platform::String ^ deviceId, IIterable<Platform::String ^> ^ additionalProperties);
/// [Windows.Foundation.Metadata.Overload("CreateFromIdAsyncAdditionalProperties")]
 static IAsyncOperation<DeviceInformation> CreateFromIdAsync(winrt::hstring const& deviceId, IIterable<winrt::hstring> const& additionalProperties);
[Windows.Foundation.Metadata.Overload("CreateFromIdAsyncAdditionalProperties")]
public static IAsyncOperation<DeviceInformation> CreateFromIdAsync(string deviceId, IEnumerable<string> additionalProperties);
function createFromIdAsync(deviceId, additionalProperties)
Public Shared Function CreateFromIdAsync (deviceId As String, additionalProperties As IEnumerable(Of String)) As IAsyncOperation(Of DeviceInformation)

Parámetros

deviceId
String

Platform::String

winrt::hstring

Cadena que contiene el id. deviceInformation .

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Lista iterable de propiedades adicionales que se van a incluir en la propiedad Properties de los objetos DeviceInformation en los resultados de la enumeración. Para obtener más información sobre lo que representan las propiedades, consulta Propiedades de información del dispositivo.

Devoluciones

Objeto para iniciar y administrar la creación asincrónica del objeto DeviceInformation .

Atributos

Ejemplos

En el ejemplo siguiente se crea una lista de propiedades que se van a incluir en el objeto DeviceInformation para crear a partir de un identificador deviceInformation.La variable savedId de este ejemplo es un identificador deviceInformation guardado previamente por la aplicación, obtenido de la propiedad id del objeto DeviceInformation usado por última vez.

// Create a set of two additional properties
var propertiesToRetrieve = new Array();
propertiesToRetrieve.push("System.InterfaceClassGuid");
propertiesToRetrieve.push("System.Storage.IsPortable");

// Create a DeviceInformation object from a saved ID
var Enum = Windows.Devices.Enumeration;
var DevInf = Enum.DeviceInformation;
DevInf.createFromIdAsync(savedId, propertiesToRetrieve).then(
    function(devinfo) {
        // Use the created DeviceInformation object
        printMessage("Created DeviceInformation. Name: " + devinfo.name);
    },
    function (e) {
        displayError("Failed to create DeviceInformation: " + e.message);
    });

Consulte también

Se aplica a

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

Crea un objeto DeviceInformation a partir de un identificador deviceInformation , una lista de propiedades adicionales y un parámetro DeviceInformationKind .

public:
 static IAsyncOperation<DeviceInformation ^> ^ CreateFromIdAsync(Platform::String ^ deviceId, IIterable<Platform::String ^> ^ additionalProperties, DeviceInformationKind kind);
/// [Windows.Foundation.Metadata.Overload("CreateFromIdAsyncWithKindAndAdditionalProperties")]
 static IAsyncOperation<DeviceInformation> CreateFromIdAsync(winrt::hstring const& deviceId, IIterable<winrt::hstring> const& additionalProperties, DeviceInformationKind const& kind);
[Windows.Foundation.Metadata.Overload("CreateFromIdAsyncWithKindAndAdditionalProperties")]
public static IAsyncOperation<DeviceInformation> CreateFromIdAsync(string deviceId, IEnumerable<string> additionalProperties, DeviceInformationKind kind);
function createFromIdAsync(deviceId, additionalProperties, kind)
Public Shared Function CreateFromIdAsync (deviceId As String, additionalProperties As IEnumerable(Of String), kind As DeviceInformationKind) As IAsyncOperation(Of DeviceInformation)

Parámetros

deviceId
String

Platform::String

winrt::hstring

Cadena que contiene el id. deviceInformation .

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Lista iterable de propiedades adicionales que se van a incluir en la propiedad Properties de los objetos DeviceInformation en los resultados de la enumeración. Para obtener más información sobre lo que representan las propiedades, consulta Propiedades de información del dispositivo.

kind
DeviceInformationKind

Tipo de objeto DeviceInformation que desea crear.

Devoluciones

Objeto para iniciar y administrar la creación asincrónica del objeto DeviceInformation .

Atributos

Consulte también

Se aplica a

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings)

Crea de forma asincrónica un objeto DeviceInformation a partir de un identificador deviceInformation , una lista de propiedades adicionales, un DeviceInformationKind y un objeto de configuración.

public:
 static IAsyncOperation<DeviceInformation ^> ^ CreateFromIdAsync(Platform::String ^ deviceId, IIterable<Platform::String ^> ^ additionalProperties, DeviceInformationKind kind, IDeviceEnumerationSettings ^ settings);
/// [Windows.Foundation.Metadata.Overload("CreateFromIdAsyncWithAdditionalPropertiesKindAndSettings")]
 static IAsyncOperation<DeviceInformation> CreateFromIdAsync(winrt::hstring const& deviceId, IIterable<winrt::hstring> const& additionalProperties, DeviceInformationKind const& kind, IDeviceEnumerationSettings const& settings);
[Windows.Foundation.Metadata.Overload("CreateFromIdAsyncWithAdditionalPropertiesKindAndSettings")]
public static IAsyncOperation<DeviceInformation> CreateFromIdAsync(string deviceId, IEnumerable<string> additionalProperties, DeviceInformationKind kind, IDeviceEnumerationSettings settings);
function createFromIdAsync(deviceId, additionalProperties, kind, settings)
Public Shared Function CreateFromIdAsync (deviceId As String, additionalProperties As IEnumerable(Of String), kind As DeviceInformationKind, settings As IDeviceEnumerationSettings) As IAsyncOperation(Of DeviceInformation)

Parámetros

deviceId
String

Platform::String

winrt::hstring

Cadena que contiene el id. deviceInformation .

additionalProperties

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Lista iterable de propiedades adicionales que se van a incluir en la propiedad Properties del objeto DeviceInformation en los resultados de la enumeración. Para obtener más información sobre lo que representan las propiedades, consulta Propiedades de información del dispositivo.

kind
DeviceInformationKind

Tipo de objeto DeviceInformation que desea crear.

settings
IDeviceEnumerationSettings

El argumento pasado en settings es un objeto que implementa IDeviceEnumerationSettings; pero de lo contrario, el objeto es de una clase de marcador opaco (es decir, no tiene propiedades o métodos públicos). El propósito de la configuración es recuperar parámetros extendidos de una API específica del dispositivo para escenarios específicos del dispositivo que no son posibles en la API WDE estándar. Puede considerar los parámetros como botones adicionales que la superficie de la API no permite.

El objeto de configuración provendría del método GetDeviceEnumerationSettings de una API de dispositivo y contendría datos opacos. Pero actualmente no hay API que generen el objeto .

Devoluciones

Objeto de operación asincrónica que, cuando se completa, contiene un objeto DeviceInformation recién creado.

Atributos

Requisitos de Windows

Familia de dispositivos
Windows 11 Insider Preview (se introdujo en la versión 10.0.26100.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v19.0)

Se aplica a