nl::Weave::Profiles::DataManagement_Current::SubscriptionHandler

Zusammenfassung

Öffentliche Typen
@142 enum
EventCallback)(void *const aAppState, EventID aEvent, const InEventParam &aInParam, OutEventParam &aOutParam) typedef
void(*
EventID enum
HandlerId typedef
uint8_t

Öffentliche statische Funktionen
DefaultEventHandler(EventID aEvent, const InEventParam & aInParam, OutEventParam & aOutParam)
void

Öffentliche Funktionen
AbortSubscription(void)
void
Diese Funktion beendet ein Abonnement sofort. Dies ist ein synchroner Aufruf.
AcceptSubscribeRequest(const uint32_t aLivenessTimeoutSec)
EndSubscription(const uint32_t aReasonProfileId, const uint16_t aReasonStatusCode)
Diese Funktion löst das ordnungsgemäße Herunterfahren des Abos und die Bereinigung des Handler-Objekts aus.
GetBinding(void) const
GetMaxNotificationSize(void) const
uint32_t
GetPeerNodeId(void) const
uint64_t
GetSubscriptionId(uint64_t *const apSubscriptionId)
IsActive(void)
bool
IsCanceling() const
bool
IsEstablishedIdle()
bool
IsFree()
bool
IsTerminated()
bool
SetMaxNotificationSize(const uint32_t aMaxPayload)
void

Strukturen
nl::Weave::Profiles::DataManagement_Current::SubscriptionHandler::TraitInstanceInfo

Gewerkschaften
nl::Weave::Profiles::DataManagement_Current::SubscriptionHandler::InEventParam
nl::Weave::Profiles::DataManagement_Current::SubscriptionHandler::OutEventParam

Öffentliche Typen

@142

 @142

EventCallback

void(* EventCallback)(void *const aAppState, EventID aEvent, const InEventParam &aInParam, OutEventParam &aOutParam)

EventID

 EventID

HandlerId

uint8_t HandlerId

Öffentliche statische Funktionen

DefaultEventHandler

void DefaultEventHandler(
  EventID aEvent,
  const InEventParam & aInParam,
  OutEventParam & aOutParam
)

Öffentliche Funktionen

AbortSubscription

void AbortSubscription(
  void
)

Diese Funktion beendet ein Abonnement sofort. Dies ist ein synchroner Aufruf.

Abo beim Verlag oder Webpublisher abbrechen

Es wird nicht versucht, den Kunden über die Beendigung zu informieren. Der zugrunde liegende Anzeigenplattformkontext wird, falls vorhanden, sofort abgebrochen. Nach diesem Aufruf wird die Anwendung nicht über weitere Aktivitäten in Bezug auf dieses Objekt informiert. Außerdem darf die Anwendung anschließend über keine ihrer Methoden mit diesem Objekt interagieren.

Beendet das Abo des Verlags oder Webpublishers, ohne den Aboclient zu benachrichtigen und ohne ein OnSubscriptionTerminated-Ereignis an den Event-Handler der Anwendung zu senden. Wenn ein gegenseitiges Abonnement vorhanden ist, wird auch das Zählerabo vom Publisher zurück an den Client beendet.

Nach dem Aufrufen von AbortSubscription() wechselt das Objekt SubscriptionHandler in den Status Terminated. Wenn es nach Abschluss des Beendigungsvorgangs keine weiteren Verweise auf das Objekt gibt, wird das SubscriptionHandler-Objekt freigegeben.

AcceptSubscribeRequest

WEAVE_ERROR AcceptSubscribeRequest(
  const uint32_t aLivenessTimeoutSec
)

EndSubscription

WEAVE_ERROR EndSubscription(
  const uint32_t aReasonProfileId,
  const uint16_t aReasonStatusCode
)

Diese Funktion löst das ordnungsgemäße Herunterfahren des Abos und die Bereinigung des Handler-Objekts aus.

Sie können ein Abo beim Verlag oder Webpublisher ordnungsgemäß beenden.

Dies ist ein asynchroner Aufruf und benachrichtigt einen Client über die bevorstehende Einstellung mit einer SubscribeCancel/StatusReport-Nachricht, sofern relevant.

Insbesondere wird dadurch auf die Beteiligung der Anwendung an diesem Abo verzichtet. Nach diesem Aufruf wird die Anwendung nicht über weitere Aktivitäten in Bezug auf dieses Objekt informiert. Außerdem darf die Anwendung anschließend über keine ihrer Methoden mit diesem Objekt interagieren.

Kündigt das Abo des Verlags oder Webpublishers ordnungsgemäß. Wenn die Unterstützung für die Kündigung von Abos aktiviert ist, wird eine „SubscribeCancelRequest“-Nachricht an den Abo-Client gesendet und das System wartet auf eine Antwort, bevor das Abo gekündigt wird. Andernfalls wird das Abo auf ähnliche Weise wie AbortSubscription() sofort gekündigt. Wenn ein gegenseitiges Abonnement vorhanden ist, wird auch das Zählerabo vom Publisher zurück an den Client beendet.

Details
Parameter
[in] aReasonProfileId
ProfileId des Statuscodes, der den Grund für die Beendigung angibt
[in] aReasonStatusCode
Statuscode, der den Grund für die Kündigung angibt
Rückgabewerte
Returns
Weave-Fehlercode nur zu Informationszwecken. Bei jedem Fehler wird das Objekt synchron beendet (d. h. abgebrochen).

Während die SubscriptionHandler auf eine Antwort auf eine SubscribeCancelRequest wartet, wechselt sie in den Status Canceling.

Sobald der Beendigungsprozess beginnt, wechselt das SubscriptionHandler-Objekt in den Status Terminated und ein OnSubscriptionTerminated-Ereignis wird an den Event-Handler der Anwendung gesendet. Wenn die Unterstützung zum Abbrechen nicht aktiviert ist, kann der Event-Handler innerhalb des Aufrufs von EndSubscription() synchron aufgerufen werden.

Wenn es nach der Rückgabe des Event-Handlers der Anwendung keine weiteren Verweise auf das SubscriptionHandler-Objekt gibt, wird das Objekt freigegeben.

GetBinding

Binding * GetBinding(
  void
) const

GetMaxNotificationSize

uint32_t GetMaxNotificationSize(
  void
) const

GetPeerNodeId

uint64_t GetPeerNodeId(
  void
) const

GetSubscriptionId

WEAVE_ERROR GetSubscriptionId(
  uint64_t *const apSubscriptionId
)

IsActive

bool IsActive(
  void
)

IsCanceling

bool IsCanceling() const

IsEstablishedIdle

bool IsEstablishedIdle()

IsFree

bool IsFree()

IsTerminated

bool IsTerminated()

SetMaxNotificationSize

void SetMaxNotificationSize(
  const uint32_t aMaxPayload
)