Compartilhar via


ActivationRegistrationManager.RegisterForProtocolActivation Método

Definição

Registra-se para ativar o aplicativo quando o esquema de URI especificado é executado por meio ShellExecute, Launcher.LaunchUriAsyncou a linha de comando.

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)

Parâmetros

scheme
String

Platform::String

winrt::hstring

O esquema de URI a ser registrado para ativações, como https.

logo
String

Platform::String

winrt::hstring

O caminho para a imagem ou o recurso usado pelo Windows para o esquema de URI. Para aplicativos empacotados, esse parâmetro é um caminho relativo ao pacote para um arquivo de imagem. Para desempacotado, esse parâmetro é um caminho de arquivo literal para um arquivo binário (DLL, EXE) mais um índice de recurso.

displayName
String

Platform::String

winrt::hstring

Esse nome de exibição usado pelo Windows para o esquema de URI.

exePath
String

Platform::String

winrt::hstring

O caminho para o executável a ser ativado. Se você passar uma cadeia de caracteres vazia, o exectuável atual será ativado por padrão. Normalmente, esse parâmetro é especificado se o chamador desse método for o instalador do aplicativo em vez do próprio aplicativo.

Atributos

Comentários

Os aplicativos empacotados devem continuar a usar o manifesto appx para registrar-se para ativação de tipo de arquivo, protocolo ou inicialização. Em seguida, eles podem usar Microsoft.Windows.AppLifecycle.AppInstance.GetActivatedEventArgs ou Windows.ApplicationModel.AppInstance.GetActivatedEventArgs para recuperar os argumentos sobre ativação.

Aplica-se a

Confira também