정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

Launcher.LaunchFileAsync(IStorageFile, LauncherOptions) | launchFileAsync(IStorageFile, LauncherOptions) Method

지정된 옵션을 사용하여 지정된 파일과 연결된 기본 응용 프로그램을 시작합니다.

구문


Windows.System.Launcher.launchFileAsync(file, options).done( /* 성공 및 오류 처리기 */ );

매개 변수

file

형식: IStorageFile

파일입니다.

options

형식: LauncherOptions

응용 프로그램에 대한 시작 옵션입니다.

반환 값

형식: IAsyncOperation<Boolean>

시작 작업입니다.

설명

호출 앱은 API가 호출될 때 사용자에게 표시되어야 합니다.

또한 이 API는 시작할 수 있는 파일 형식에 대해 몇 가지 제한을 적용합니다. 실행 코드(.exe, .msi 및 .js 파일)가 포함된 몇몇 파일 형식은 시작부터 차단됩니다. 이 제한은 시스템을 수정할 수 있는 잠재적으로 악의적인 파일로부터 사용자를 보호합니다.

위와 같은 이유로 시작하지 못하면 API가 성공하고 비동기 작업에서 FALSE를 반환합니다. 위의 제한이 현재 실행에 적용되는지 여부를 쿼리할 수 있는 기능이 없으므로 호출 앱에서는 실행에 성공했다고 가정해서는 안 되며 실패한 경우 피드백 메커니즘을 제공해야 합니다. 사용자에게 파일을 저장하고 데스크톱에서 열도록 하면 해결될 수도 있습니다.

사용자가 기본 앱을 시작하는 대신 앱을 선택할 수 있도록 하려면 LauncherOptions.DisplayApplicationPicker | displayApplicationPicker 속성을 설정합니다.

파일이 잠재적으로 안전하지 않다는 경고를 표시하려면 LauncherOptions.TreatAsUntrusted | treatAsUntrusted 속성을 설정합니다.

파일은 연결된 앱으로 전달됩니다. 연결된 앱이 데스크톱 앱일 경우 파일은 셸 실행 메커니즘을 사용하여 전달됩니다.

Windows Phone 8

이 API는 구현되어 있지 않으므로 호출할 경우 예외가 throw됩니다. Windows Phone 런타임 API를 참조하십시오.

예제

LauncherOptions.DisplayApplicationPicker | displayApplicationPickertrue로 설정한 상태에서 Launcher.LaunchFileAsync(IStorageFile, LauncherOptions) | launchFileAsync(IStorageFile, LauncherOptions) 메서드를 호출하여 사용자가 연결 프로그램 대화 상자에서 파일에 대해 선택하는 앱을 시작합니다.



// Path to the file in the app package to launch
var imageFile = "images\\test.png";

// Get the image file from the package's image directory
Windows.ApplicationModel.Package.current.installedLocation.getFileAsync(imageFile).then(
  function (file) {
    // Set the show picker option
    var options = new Windows.System.LauncherOptions();
    options.displayApplicationPicker = true;

    // Launch the retrieved file using the selected app
    Windows.System.Launcher.launchFileAsync(file, options).then(
      function (success) {
        if (success) {
            // File launched
        } else {
            // File launch failed
        }
      });
  });

요구 사항

지원되는 최소 클라이언트

Windows 8

지원되는 최소 서버

Windows Server 2012

지원되는 최소 전화

Windows Phone 8[구현되지 않음, 설명 참조]

Namespace

Windows.System
Windows::System [C++]

Metadata

Windows.winmd

참고 항목

샘플
연결 시작 샘플
지침
파일 형식 및 URI를 위한 지침 및 검사 목록
작업
파일의 기본 앱을 시작하는 방법(JavaScript)
파일의 기본 앱을 시작하는 방법(C#/VB/C++)
참조
Launcher
LaunchFileAsync(IStorageFile, LauncherOptions)

 

 

표시: