ActivationRegistrationManager.RegisterForProtocolActivation 方法

定义

通过 ShellExecuteLauncher.LaunchUriAsync或命令行执行指定的 URI 方案时注册以激活应用。

public:
 static void RegisterForProtocolActivation(Platform::String ^ scheme, Platform::String ^ logo, Platform::String ^ displayName, Platform::String ^ exePath);
/// [Windows.Foundation.Metadata.Experimental]
 static void RegisterForProtocolActivation(winrt::hstring const& scheme, winrt::hstring const& logo, winrt::hstring const& displayName, winrt::hstring const& exePath);
 static void RegisterForProtocolActivation(winrt::hstring const& scheme, winrt::hstring const& logo, winrt::hstring const& displayName, winrt::hstring const& exePath);
[Windows.Foundation.Metadata.Experimental]
public static void RegisterForProtocolActivation(string scheme, string logo, string displayName, string exePath);
public static void RegisterForProtocolActivation(string scheme, string logo, string displayName, string exePath);
function registerForProtocolActivation(scheme, logo, displayName, exePath)
Public Shared Sub RegisterForProtocolActivation (scheme As String, logo As String, displayName As String, exePath As String)

参数

scheme
String

Platform::String

winrt::hstring

要注册激活的 URI 方案,例如 https

logo
String

Platform::String

winrt::hstring

Windows 用于 URI 方案的图像或资源的路径。 对于打包的应用,此参数是映像文件的包相对路径。 对于解压缩,此参数是二进制文件(DLL,EXE)加上资源索引的文本文件路径。

displayName
String

Platform::String

winrt::hstring

Windows 用于 URI 方案的此显示名称。

exePath
String

Platform::String

winrt::hstring

要激活的可执行文件的路径。 如果传递空字符串,则默认情况下将激活当前可选项。 如果此方法的调用方是应用的安装程序而不是应用本身,则通常指定此参数。

属性

注解

打包的应用应继续使用其 appx 清单注册文件类型、协议或启动激活。 然后,可以使用 Microsoft.Windows.AppLifecycle.AppInstance.GetActivatedEventArgsWindows.ApplicationModel.AppInstance.GetActivatedEventArgs 检索激活参数。

适用于

另请参阅