패키지 ID 및 런타임 컨텍스트 검색Detect package identity and runtime context

MSIX 패키지에 배포되지 않은 일부 버전의 앱이 있을 수 있습니다.You may have some versions of your app that were not distributed in an MSIX package. 런타임에 앱에서 Windows 패키지 관리자 API 또는 사용자 지정 설치 관리자를 사용하여 MSIX 패키지로 배포되었는지 여부를 검색할 수 있습니다.At runtime your app can detect whether it was deployed as an MSIX package by using the Windows Package Manager API, or your own custom installer. 업데이트 설정과 같은 앱 동작을 변경하거나 MSIX 패키지에서만 사용할 수 있는 기능을 활용하는 것이 좋습니다.You may want to change the app behavior such as update settings or you may want to take advantage of functionality only available to MSIX packages.

애플리케이션이 전체 MSIX 기능 세트를 지원하는 Windows 버전에서 MSIX 패키지로 실행되는지 확인하려면 kernel32.dll에서 GetCurrentPackageFullName 네이티브 함수를 사용할 수 있습니다.To determine whether your application is running as an MSIX package on a version of Windows that supports the full MSIX feature set, you can use the GetCurrentPackageFullName native function in kernel32.dll. 데스크톱 애플리케이션이 패키지 ID가 없는 패키지되지 않은 애플리케이션으로 실행되는 경우 이 함수에서 앱이 실행되는 컨텍스트를 유추하는 데 도움이 되는 오류를 반환합니다.When a desktop application is running as a non-packaged application without package identity, this function returns an error which can help you infer the context in which the app is running.

함수 성공은 다음을 의미합니다.If the function succeeds, it means:

  • 앱이 MSIX 패키지로 패키지되었습니다.Your app is packaged in an MSIX package.
  • 앱이 전체 MSIX를 지원하는 Windows 10 버전 1709(빌드 16299) 이상에서 실행됩니다.Your app is running on Windows 10, version 1709 (build 16299) or later with full MSIX support.

네이티브 코드에서 GetCurrentPackageFullName 사용Use GetCurrentPackageFullName in native code

다음 코드 예제에서는 GetCurrentPackageFullName을 사용하여 앱의 컨텍스트를 확인하는 방법을 보여 줍니다.The following code example demonstrates how to use GetCurrentPackageFullName to determine the context of an app.

#define _UNICODE 1
#define UNICODE 1

#include <Windows.h>
#include <appmodel.h>
#include <malloc.h>
#include <stdio.h>

int __cdecl wmain()
{
    UINT32 length = 0;
    LONG rc = GetCurrentPackageFullName(&length, NULL);
    if (rc != ERROR_INSUFFICIENT_BUFFER)
    {
        if (rc == APPMODEL_ERROR_NO_PACKAGE)
            wprintf(L"Process has no package identity\n");
        else
            wprintf(L"Error %d in GetCurrentPackageFullName\n", rc);
        return 1;
    }

    PWSTR fullName = (PWSTR) malloc(length * sizeof(*fullName));
    if (fullName == NULL)
    {
        wprintf(L"Error allocating memory\n");
        return 2;
    }

    rc = GetCurrentPackageFullName(&length, fullName);
    if (rc != ERROR_SUCCESS)
    {
        wprintf(L"Error %d retrieving PackageFullName\n", rc);
        return 3;
    }
    wprintf(L"%s\n", fullName);

    free(fullName);

    return 0;
}

관리 코드에서 GetCurrentPackageFullName 함수 사용Use GetCurrentPackageFullName function in managed code

관리형 .NET Framework 앱에서 GetCurrentPackageFullName을 호출하려면 플랫폼 호출(P/Invoke) 또는 다른 형태의 interop를 사용해야 합니다.To call GetCurrentPackageFullName in a managed .NET Framework app, you'll need to use Platform Invoke (P/Invoke) or some other form of interop.

이 프로세스를 간소화하기 위해 DesktopBridgeHelpers 라이브러리를 사용할 수 있습니다.To simplify this process, you can use the DesktopBridgeHelpers library. 이 라이브러리는 .NET Framework 4 이상을 지원하며, 내부적으로 P/Invoke를 사용하여 전체 MSIX 기능 세트를 지원하는 Windows 버전에서 앱이 실행되는지 여부를 결정하는 도우미 클래스를 제공합니다.This library supports .NET Framework 4 and later, and it uses P/Invoke internally to provide a helper class that determines whether the app is running on a version of Windows that supports the full MSIX feature set. 이 라이브러리는 NuGet 패키지로도 사용할 수 있습니다.This library is also available as a NuGet Package.

패키지가 프로젝트에 설치되면 DesktopBridge.Helpers 클래스의 새 인스턴스를 만들고 IsRunningAsUwp 메서드를 호출할 수 있습니다.After you install the package in your project, you can create a new instance of the DesktopBridge.Helpers class and call the IsRunningAsUwp method. 앱이 Windows 10 버전 1709(빌드 16299) 이상에서 MSIX 패키지로 실행되는 경우 이 메서드는 true를 반환하고 둘 중 하나에 해당하지 않는 경우 false를 반환합니다.This method returns true if your app is running as an MSIX package on Windows 10, version 1709 (build 16299) or later and false if either of those are not true. 다음 샘플에서는 이 메서드를 호출하는 방법을 보여 줍니다.The following sample demonstrates how to call this method.

private bool IsRunningAsUwp()
{
   UwpHelpers helpers = new UwpHelpers();
   return helpers.IsRunningAsUwp();
}

private void Form1_Load(object sender, EventArgs e)
{
   if (IsRunningAsUwp())
   {
       txtUwp.Text = "I'm running as MSIX";
   }
   else
   {
       txtUwp.Text = "I'm running as a native desktop app";
   }
}