ITransferSource::Advise-Methode (shobjidl_core.h)

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.

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