HardwareIdentification 클래스

정의

네임스페이스:

Windows.System.Profile

현재 하드웨어를 나타내는 하드웨어 식별자를 가져오는 기능을 제공합니다.

public ref class HardwareIdentification abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.System.Profile.ProfileHardwareTokenContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class HardwareIdentification final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.System.Profile.ProfileHardwareTokenContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public static class HardwareIdentification

Public Class HardwareIdentification

상속

Object Platform::Object IInspectable HardwareIdentification

특성

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 요구 사항

디바이스 패밀리	Windows Desktop Extension SDK (10.0.10240.0에서 도입되었습니다.) Windows Mobile Extension SDK (10.0.10240.0에서 도입되었습니다.) Windows 10 Anniversary Edition (10.0.14393.0에서 도입되었습니다.)
API contract	Windows.System.Profile.ProfileHardwareTokenContract (v1.0에서 도입되었습니다.)

예제

다음 코드에서는 GetPackageSpecificToken을 사용하여 디바이스의 하드웨어 ID를 가져오는 방법을 보여 줍니다.

// nonce is an IBuffer object that would be sent from the cloud service.
HardwareToken packageSpecificToken;

packageSpecificToken =  Windows.System.Profile.HardwareIdentification.GetPackageSpecificToken(nonce);

// hardware id, signature, certificate IBuffer objects 
// that can be accessed through properties.
IBuffer hardwareId  = packageSpecificToken.Id;
IBuffer signature = packageSpecificToken.Signature;
IBuffer certificate = packageSpecificToken.Certificate;

void MainPage::DefaultLaunch()
{
    // nonce is a value of type Windows::Storage::Streams::IBuffer, which
    // would be sent from the cloud service in a real scenario.
    Windows::System::Profile::HardwareToken packageSpecificToken{
        Windows::System::Profile::HardwareIdentification::GetPackageSpecificToken(nonce) };

    // hardware id, signature, certificate IBuffer objects 
    // that can be accessed through properties.
    Windows::Storage::Streams::IBuffer hardwareId{ packageSpecificToken.Id() };
    Windows::Storage::Streams::IBuffer signature{ packageSpecificToken.Signature() };
    Windows::Storage::Streams::IBuffer certificate{ packageSpecificToken.Certificate() };
}

// nonce is an IBuffer object that would be sent from the cloud service.
HardwareToken^ packageSpecificToken;

packageSpecificToken =  Windows::System::Profile::HardwareIdentification::GetPackageSpecificToken(nonce);

// hardware id, signature, certificate IBuffer objects 
// that can be accessed through properties.
IBuffer^ hardwareId = packageSpecificToken->Id;
IBuffer^ signature = packageSpecificToken->Signature;
IBuffer^ certificate = packageSpecificToken->Certificate;

// nonce is an IBuffer object that would be sent from the cloud service.
Dim packageSpecificToken As Windows.System.Profile.HardwareToken

packageSpecificToken = Windows.System.Profile.HardwareIdentification.GetPackageSpecificToken(nonce)

// hardware id, signature, certificate IBuffer objects 
// that can be accessed through properties.
Dim hardwareId As Windows.Storage.Streams.IBuffer = packageSpecificToken.Id
Dim signature As Windows.Storage.Streams.IBuffer = packageSpecificToken.Signature
Dim certificate As Windows.Storage.Streams.IBuffer = packageSpecificToken.Certificate

설명

자세한 내용은 ASHWID(앱별 하드웨어 ID)를 사용하여 디바이스별 앱 논리 구현에 대한 지침을 참조하세요.

참고

이 클래스는 민첩하지 않으므로 스레딩 모델 및 마샬링 동작을 고려해야 합니다. 자세한 내용은 스레딩 및 마샬링(C++/CX) 및 다중 스레드 환경(.NET)에서 Windows 런타임 개체 사용을 참조하세요.

메서드

GetPackageSpecificToken(IBuffer)

현재 하드웨어를 나타내는 ASHWID(하드웨어 식별자)를 가져옵니다. 반환된 ASHWID 는 각 애플리케이션 패키지에 대해 다릅니다. 즉, 이 API는 서로 다른 패키지의 두 앱에서 호출될 때 서로 다른 식별자를 반환합니다. 동일한 패키지의 일부인 두 앱에서 호출될 때 동일한 식별자를 반환합니다.

추가 정보

• ASHWID(앱별 하드웨어 ID)를 사용하여 디바이스별 앱 논리 구현에 대한 지침