IPortableDeviceServiceMethods::InvokeAsync-Methode (portabledeviceapi.h)

Die InvokeAsync-Methode ruft asynchron eine Methode auf.

Syntax

HRESULT InvokeAsync(
  [in] REFGUID                              Method,
  [in] IPortableDeviceValues                *pParameters,
  [in] IPortableDeviceServiceMethodCallback *pCallback
);

Parameter

[in] Method

Die aufzurufende Methode.

[in] pParameters

Ein Zeiger auf eine IPortableDeviceValues-Schnittstelle , die die Parameter der aufgerufenen Methode enthält, oder NULL , um anzugeben, dass die Methode über keine Parameter verfügt.

[in] pCallback

Ein Zeiger auf ein von der Anwendung bereitgestelltes IPortableDeviceServiceMethodCallback-Rückrufobjekt , das die Methodenergebnisse empfängt, oder NULL , um die Methodenergebnisse zu ignorieren.

Rückgabewert

Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Jeder andere HRESULT-Wert gibt an, dass beim Aufruf ein Fehler aufgetreten ist.

Hinweise

Beim Aufrufen mehrerer Methoden können Clients eine separate instance der IPortableDeviceServiceMethodCallback-Schnittstelle für jeden Aufruf erstellen und einen Kontext mit diesem instance -Objekt speichern, bevor es an die InvokeAsync-Methode übergeben wird. Auf diese Weise kann der Methodenvorgang identifiziert werden, wenn die OnComplete-Methode aufgerufen wird. Die Verwendung eines eindeutigen Objekts für jeden Aufruf ermöglicht auch das gezielte Abbrechen eines Vorgangs durch die Cancel-Methode .

Beispiele

Ein Beispiel für die Verwendung dieser Methode finden Sie unter Aufrufen von Dienstmethoden asynchron.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	portabledeviceapi.h

Weitere Informationen

IPortableDeviceServiceMethods-Schnittstelle

Aufrufen von Dienstmethoden asynchron