ITransferSource::Advise-Methode (shobjidl_core.h)

Artikel
08/26/2023

Richtet eine Empfehlungsverbindung für Benachrichtigungen über die status von Dateivorgängen ein.

Syntax

HRESULT Advise(
  [in]  ITransferAdviseSink *psink,
  [out] DWORD               *pdwCookie
);

Parameter

[in] psink

Typ: ITransferAdviseSink*

Ein Zeiger auf die Benachrichtigungsschnittstelle ITransferAdviseSink , um die aufrufende Anwendung mithilfe von Methoden auf dieser Schnittstelle zu aktualisieren.

[out] pdwCookie

Typ: DWORD*

Ein Zeiger auf ein zurückgegebenes Token, das diese Verbindung eindeutig identifiziert. Die aufrufende Anwendung verwendet dieses Token später, um die Verbindung zu löschen, indem sie sie an die ITransferSource::Unadvise-Methode übergibt . Wenn die Verbindung nicht erfolgreich hergestellt wurde, ist dieser Wert 0.

Rückgabewert

Typ: HRESULT

Alle anderen HRESULTs als aufgeführt weisen auf einen Fehler hin.

Rückgabecode	BESCHREIBUNG
S_OK	Die Schnittstelle wurde erfolgreich zugeordnet.
E_UNEXPECTED	Der Handler kann nur eine Senkeschnittstelle verarbeiten.

Hinweise

Rufen Sie ITransferSource::Advise auf, bevor Sie andere Methoden in dieser Schnittstelle aufrufen, um eine Beratungssitzung zu aktivieren. Wenn nicht festgelegt, sollte der Handler dies als Hinweis betrachten, dass kein Feedback verfügbar ist, und den "Standard"-Vorgang ausführen, ohne die aufrufende Anwendung zu konsultieren.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)

Share via