DeviceInformation.CreateFromIdAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
CreateFromIdAsync(String) |
DeviceInformation ID에서 DeviceInformation 개체를 만듭니다. |
CreateFromIdAsync(String, IIterable<String>) |
DeviceInformation ID 및 추가 속성 목록에서 DeviceInformation 개체를 만듭니다. |
CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind) |
DeviceInformation ID, 추가 속성 목록 및 DeviceInformationKind 매개 변수에서 DeviceInformation 개체를 만듭니다. |
CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings) |
DeviceInformation ID, 추가 속성 목록, DeviceInformationKind 및 설정 개체에서 DeviceInformation 개체를 비동기적으로 만듭니다. |
CreateFromIdAsync(String)
DeviceInformation ID에서 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)
매개 변수
- deviceId
-
String
Platform::String
winrt::hstring
디바이스 ID
반환
DeviceInformation 개체의 비동기 생성을 시작하고 관리하기 위한 개체입니다.
- 특성
예제
이 예제의 savedId 변수는 애플리케이션에서 이전에 저장한 DeviceInformation ID로, 마지막으로 사용한 DeviceInformation 개체의 id 속성에서 가져옵니다.
// 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);
});
추가 정보
적용 대상
CreateFromIdAsync(String, IIterable<String>)
DeviceInformation ID 및 추가 속성 목록에서 DeviceInformation 개체를 만듭니다.
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)
매개 변수
- deviceId
-
String
Platform::String
winrt::hstring
DeviceInformation ID를 포함하는 문자열입니다.
열거형 결과에서 DeviceInformation 개체의 Properties 속성에 포함할 추가 속성의 반복 가능한 목록입니다. 속성이 나타내는 항목에 대한 자세한 내용은 디바이스 정보 속성을 참조하세요.
반환
DeviceInformation 개체의 비동기 생성을 시작하고 관리하기 위한 개체입니다.
- 특성
예제
다음 예제에서는 DeviceInformation ID에서 만들 DeviceInformation 개체에 포함할 속성 목록을 작성합니다. 이 예제의 savedId 변수는 애플리케이션에서 이전에 저장한 DeviceInformation ID로, 마지막으로 사용한 DeviceInformation 개체의 id 속성에서 가져옵니다.
// 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);
});
추가 정보
적용 대상
CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind)
DeviceInformation ID, 추가 속성 목록 및 DeviceInformationKind 매개 변수에서 DeviceInformation 개체를 만듭니다.
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)
매개 변수
- deviceId
-
String
Platform::String
winrt::hstring
DeviceInformation ID를 포함하는 문자열입니다.
열거형 결과에서 DeviceInformation 개체의 Properties 속성에 포함할 추가 속성의 반복 가능한 목록입니다. 속성이 나타내는 항목에 대한 자세한 내용은 디바이스 정보 속성을 참조하세요.
만들려는 DeviceInformation 개체의 형식입니다.
반환
DeviceInformation 개체의 비동기 생성을 시작하고 관리하기 위한 개체입니다.
- 특성
추가 정보
적용 대상
CreateFromIdAsync(String, IIterable<String>, DeviceInformationKind, IDeviceEnumerationSettings)
DeviceInformation ID, 추가 속성 목록, DeviceInformationKind 및 설정 개체에서 DeviceInformation 개체를 비동기적으로 만듭니다.
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)
매개 변수
- deviceId
-
String
Platform::String
winrt::hstring
DeviceInformation ID를 포함하는 문자열입니다.
열거형 결과에서 DeviceInformation 개체의 Properties 속성에 포함할 추가 속성의 반복 가능한 목록입니다. 속성이 나타내는 항목에 대한 자세한 내용은 디바이스 정보 속성을 참조하세요.
만들려는 DeviceInformation 개체의 형식입니다.
- settings
- IDeviceEnumerationSettings
설정에 전달된 인수는 IDeviceEnumerationSettings를 구현하는 개체입니다. 그러나 그렇지 않으면 개체가 불투명 마커 클래스(즉, 공용 속성 또는 메서드가 없음)입니다. 설정의 목적은 표준 WDE API에서 불가능한 디바이스별 시나리오에 대한 디바이스별 API에서 확장 매개 변수를 검색하는 것입니다. API 표면에서 허용하지 않는 추가 노브와 같은 매개 변수를 생각할 수 있습니다.
설정 개체는 디바이스 API의 GetDeviceEnumerationSettings 메서드에서 제공되며 불투명 데이터를 포함합니다. 그러나 현재 개체를 생성하는 API는 없습니다.
반환
완료되면 새로 만든 DeviceInformation 개체를 포함하는 비동기 작업 개체입니다.
- 특성
Windows 요구 사항
디바이스 패밀리 |
Windows 11 Insider Preview (10.0.26100.0에서 도입되었습니다.)
|
API contract |
Windows.Foundation.UniversalApiContract (v19.0에서 도입되었습니다.)
|