ITransferDestination::Advise-Methode (shobjidl_core.h)

Artikel
03/04/2024

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 eine ITransferAdviseSink-Benachrichtigungsschnittstelle , 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 es an die ITransferDestination::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 ITransferDestination::Advise auf, bevor Sie andere ITransferDestination-Methoden aufrufen, damit der Handler bei eventuell auftretenden Fehlern rückrufen kann. Wenn nicht festgelegt, sollte der Handler dies als Hinweis darauf betrachten, dass kein Feedback verfügbar ist, und den "Standard"-Vorgang ausführen.

Anforderungen

Anforderung	Wert
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)

Freigeben über