AppInstance.FindOrRegisterForKey(String) Método

Definición

Espacio de nombres:

Microsoft.Windows.AppLifecycle

Registra una instancia de aplicación con la plataforma o busca una instancia existente si otra instancia ya ha registrado esta clave.

public:
 static AppInstance ^ FindOrRegisterForKey(Platform::String ^ key);

 static AppInstance FindOrRegisterForKey(winrt::hstring const& key);

public static AppInstance FindOrRegisterForKey(string key);

function findOrRegisterForKey(key)

Public Shared Function FindOrRegisterForKey (key As String) As AppInstance

Parámetros

key

String

Platform::String

winrt::hstring

Cadena no vacía como clave para la instancia de .

Devoluciones

AppInstance

Instancia de aplicación que representa la primera aplicación que registró la clave. El autor de la llamada puede determinar si esa instancia es la instancia actual.

Comentarios

Mientras que el método FindOrRegisterInstanceForKey en el sistema operativo Windows es específico del redireccionamiento de instancias, este método del SDK de Aplicaciones para Windows permite que la aplicación registre una clave por cualquier motivo.

Una vez que una aplicación se ha registrado con la plataforma, se devuelve cuando otras instancias consultan instancias de la aplicación.

Una instancia de aplicación puede registrarse varias veces con claves diferentes. La memoria caché del sistema mantiene una fila por instancia, por lo tanto, la clave se sobrescribe.

Consulte también

• UnregisterKey()
• Creación de instancias de aplicaciones