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 |