IApplicationActivationManager::ActivateForFile-Methode (shobjidl_core.h)

Aktiviert die angegebene Windows Store-App für den Dateivertrag (Windows.File).

Syntax

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

Parameter

[in] appUserModelId

Die Anwendungsbenutzermodell-ID der Windows Store-App.

[in] itemArray

Ein Zeiger auf ein Array von Shellelementen, die jeweils eine Datei darstellen. Dieser Wert wird in eine VectorView von StorageItem-Objekten konvertiert, die über FileActivatedEventArgs an die App übergeben wird.

[in] verb

Das Verb, das auf die von itemArray angegebene Datei oder Dateien angewendet wird.

[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