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) |