IUPnPServiceAsync::BeginSubscribeToEvents-Methode (upnp.h)

Artikel
03/03/2024

BeginSubscribeToEvents initiiert ein Ereignisabonnement im asynchronen Modus und registriert den Anwendungsrückruf beim UPnP-Framework.

Syntax

HRESULT BeginSubscribeToEvents(
  [in]           IUnknown         *pUnkCallback,
  [in, optional] IUPnPAsyncResult *pAsyncResult,
  [out]          PULONG64         pullRequestID
);

Parameter

[in] pUnkCallback

Gibt den Verweis auf das Schnittstellenobjekt an, das den zu registrierenden Rückruf enthält. Dieses Objekt muss entweder die IUPnPServiceCallback-Schnittstelle oder die IDispatch-Schnittstelle unterstützen.

[in, optional] pAsyncResult

Gibt einen Verweis auf das IUPnPAsyncResult-Objekt an. Wenn der BeginSubscribeToEvents-Aufruf abgeschlossen ist, verwendet UPnP die IUPnPAsyncResult::AsyncOperationComplete-Methode , um den Steuerungspunkt zu benachrichtigen.

[out] pullRequestID

Zeiger auf einen 64-Bit-ULONG-Wert , der zum Identifizieren des asynchronen E/A-Vorgangs verwendet wird. Der Steuerungspunkt muss dieses Handle beim Beenden oder Abbrechen des Vorgangs über EndSubscribeToEvents oder CancelAsyncOperation verwenden.

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_FAIL	Fehler beim Initiieren des asynchronen Vorgangs.

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

Hinweise

Das Ereignisabonnement sollte vor dem Abfragen von Ereigniszustandsvariablen mit BeginQueryStateVariable abgeschlossen werden. Wenn dies nicht der Fall ist, wird UPNP_E_VARIABLE_VALUE_UNKNOWN zurückgegeben, und das Ereignisabonnement erfolgt intern. Daher ist der nächste BeginQueryStateVariable-Aufruf erfolgreich.

Hinweis Bei Diensten ohne Ereignisvariable verhält sich BeginQueryStateVariable immer wie erwartet.

Wenn Sie diese Methode mehrmals aufrufen, werden mehrere Rückrufe hinzugefügt.

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::CancelAsyncOperation

IUPnPServiceAsync::EndSubscribeToEvents

Freigeben über