Metodo IApplicationActivationManager::ActivateApplication (shobjidl_core.h)

  • Articolo

Attiva l'app di Windows Store specificata per il contratto di avvio generico (Windows.Launch) nella sessione corrente.

Sintassi

HRESULT ActivateApplication(
  [in]  LPCWSTR         appUserModelId,
  [in]  LPCWSTR         arguments,
  [in]  ACTIVATEOPTIONS options,
  [out] DWORD           *processId
);

Parametri

[in] appUserModelId

ID modello utente dell'applicazione dell'app di Windows Store.

[in] arguments

Puntatore a una stringa di argomento facoltativa, specifica dell'app.

[in] options

Uno o più dei flag seguenti usati per supportare scenari di progettazione, debug e test.

AO_NONE (0x00000000)

Nessun flag impostato.

AO_DESIGNMODE (0x00000001)

L'app viene attivata per la modalità progettazione, quindi non può creare la finestra normale. La creazione della finestra dell'app deve essere eseguita dagli strumenti di progettazione che caricano i componenti necessari comunicando con un servizio specificato dalla finestra di progettazione nella catena del sito stabilita tramite gestione attivazione. Si noti che ciò significa che la schermata iniziale visualizzata durante le normali attivazioni non verrà visualizzata.

Tieni presente che devi abilitare la modalità di debug nel pacchetto dell'app per usare correttamente la modalità progettazione.

AO_NOERRORUI (0x00000002)

Non visualizzare una finestra di dialogo di errore se l'app non riesce ad attivarsi.

AO_NOSPLASHSCREEN (0x00000004)

Non visualizzare la schermata iniziale dell'app quando l'app viene attivata. È necessario abilitare la modalità di debug nel pacchetto dell'app quando si usa questo flag; in caso contrario, il PLM terminerà l'app dopo alcuni secondi.

AO_PRELAUNCH (0x2000000)

L'applicazione viene attivata in modalità di preavvio. Questo valore è supportato a partire da Windows 10.

[out] processId

Puntatore a un valore che, quando questo metodo viene restituito correttamente, riceve l'ID processo dell'istanza dell'app che soddisfa il contratto.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl_core.h (include Shobjidl.h)

Vedi anche

IApplicationActivationManager

IPackageDebugSettings::EnableDebugging