IUPnPServiceAsync::BeginInvokeAction-Methode (upnp.h)

Artikel
03/06/2024

Die BeginInvokeAction-Methode ruft eine Aktion auf einem Gerät im asynchronen Modus auf. Wenn ein verzögerter SCPD-Download und ein Ereignisabonnement aktiviert ist und noch nicht erfolgt ist, initiiert diese Methode den SCPD-Download.

Syntax

HRESULT BeginInvokeAction(
  [in]           BSTR             bstrActionName,
  [in]           VARIANT          vInActionArgs,
  [in, optional] IUPnPAsyncResult *pAsyncResult,
  [out]          PULONG64         pullRequestID
);

Parameter

[in] bstrActionName

Gibt die methode an, die aufgerufen werden soll.

[in] vInActionArgs

Gibt ein Array von Eingabeargumenten für die -Methode an. Wenn die Aktion keine Eingabeargumente enthält, muss dieser Parameter ein leeres Array enthalten. Der Inhalt dieses Arrays ist dienstspezifisch.

[in, optional] pAsyncResult

Zeiger auf ein IUPnPAsyncResult-Objekt . Wenn der BeginInvokeAction-Aufruf abgeschlossen ist, verwendet UPnP die IUPnPAsyncResult::AsyncOperationComplete-Methode , um den Kontrollpunkt zu benachrichtigen.

[out] pullRequestID

Zeiger auf einen 64-Bit-ULONG-Wert , der zum Identifizieren des asynchronen E/A-Vorgangs verwendet wird. Der Kontrollpunkt muss dieses Handle als Cookie verwenden, während dieser Vorgang mit EndInvokeAction beendet oder abgebrochen wird.

Rückgabewert

Gibt bei Erfolg S_OK zurück. Andernfalls gibt die -Methode einen com-Fehlercode zurück, der in WinError.h oder einen der folgenden Werte definiert ist:

Rückgabecode	Beschreibung
E_PENDING	Ein weiterer asynchroner Vorgang wird für dieses IUPnPServiceAsync-Objekt ausgeführt. Erstellen Sie eine weitere IUPnPServiceAsync-instance, oder brechen Sie den ausgeführten Vorgang ab, indem Sie IUPnPServiceAsync::CancelAsyncOperation verwenden.
E_FAIL	Fehler beim Initiieren des Vorgangs.
UPNP_E_INVALID_ACTION	Diese Aktion wird vom Gerät nicht unterstützt.

Hinweis Einige Werte können darauf hindeuten, dass ein Fehler von einem UPnP-zertifizierten Gerät empfangen wurde. Weitere Informationen finden Sie unter Gerätefehlercodes.

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	upnp.h
DLL	Upnp.dll

Weitere Informationen

IUPnPServiceAsync

IUPnPServiceAsync::EndInvokeAction

Freigeben über