DeviceInformation.CreateFromIdAsync Método

Referencia

Definición

Espacio de nombres:: Windows.Devices.Enumeration

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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)

Editar

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

IAsyncOperation<DeviceInformation>

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

Atributos: OverloadAttribute RemoteAsyncAttribute

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

CreateFromIdAsync(String, IIterable<String>)

Se aplica a

CreateFromIdAsync(String, IIterable<String>)

Editar

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

IAsyncOperation<DeviceInformation>

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

Atributos: OverloadAttribute

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

CreateFromIdAsync(String)

Se aplica a

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

Editar

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>

kind: DeviceInformationKind

Tipo de objeto DeviceInformation que desea crear.

Devoluciones

IAsyncOperation<DeviceInformation>

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

Atributos: OverloadAttribute

Consulte también

Se aplica a

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

Editar

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

IAsyncOperation<DeviceInformation>

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

Atributos: OverloadAttribute

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

Compartir a través de

DeviceInformation.CreateFromIdAsync Método

Definición

Sobrecargas

CreateFromIdAsync(String)

Parámetros

Devoluciones

Ejemplos

Consulte también

Se aplica a

CreateFromIdAsync(String, IIterable<String>)

Parámetros

Devoluciones

Ejemplos

Consulte también

Se aplica a

CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)

Parámetros

Devoluciones

Consulte también

Se aplica a

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

Parámetros

Devoluciones

Requisitos de Windows

Se aplica a

Comentarios

Recursos adicionales