ActivationRegistrationManager.RegisterForProtocolActivation 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
通过 ShellExecute、Launcher.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.GetActivatedEventArgs 或 Windows.ApplicationModel.AppInstance.GetActivatedEventArgs 检索激活参数。