IPortableDeviceService::Advise-Methode (portabledeviceapi.h)

Artikel
03/06/2024

Die Advise-Methode registriert ein anwendungsdefiniertes Rückrufobjekt, das Dienstereignisse empfängt.

Syntax

HRESULT Advise(
  [in]  const DWORD                  dwFlags,
  [in]  IPortableDeviceEventCallback *pCallback,
  [in]  IPortableDeviceValues        *pParameters,
  [out] LPWSTR                       *ppszCookie
);

Parameter

[in] dwFlags

Wird nicht verwendet.

[in] pCallback

Die IPortableDeviceEventCallback-Schnittstelle , die das zu registrierende Rückrufobjekt angibt.

[in] pParameters

Die IPortableDeviceValues-Schnittstelle , die die Ereignisregistrierungsparameter angibt, oder NULL , wenn das Rückrufobjekt alle Dienstereignisse empfangen soll.

[out] ppszCookie

Die eindeutige Kontext-ID für das Rückrufobjekt. Dieser Wert entspricht dem Wert, der von der Unadvise-Methode zum Aufheben der Registrierung des Rückrufobjekts verwendet wird.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Für den pCallback-Parameter oder den ppszCookie-Parameter wurde ein NULL-Wert angegeben.

Hinweise

Während der Bereinigung sollte eine Anwendung die Registrierung des Rückrufobjekts aufheben, indem sie die Unadvise-Methode aufruft , und dann den Speicher freigeben, auf den der ppszCookie-Parameter verweist, indem die CoTaskMemFree-Funktion aufgerufen wird.

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

IPortableDeviceService-Schnittstelle

Freigeben über