IApplicationActivationManager::ActivateForProtocol-Methode (shobjidl_core.h)

Aktiviert die angegebene Windows Store-App für den Protokollvertrag (Windows.Protocol).

Syntax

HRESULT ActivateForProtocol(
  [in]  LPCWSTR         appUserModelId,
  [in]  IShellItemArray *itemArray,
  [out] DWORD           *processId
);

Parameter

[in] appUserModelId

Die Anwendungsbenutzermodell-ID der Windows Store-App.

[in] itemArray

Ein Zeiger auf ein Array eines einzelnen Shellelements. Das erste Element im Array wird in ein URI-Objekt konvertiert, das über ProtocolActivatedEventArgs an die App übergeben wird. Alle Elemente im Array mit Ausnahme des ersten Elements werden ignoriert.

[out] processId

Ein Zeiger auf einen Wert, der bei erfolgreicher Rückgabe dieser Methode die Prozess-ID der App instance empfängt, die diesen Vertrag erfüllt.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)

Weitere Informationen

IApplicationActivationManager