IFileOperation::Advise-Methode (shobjidl_core.h)

  • Artikel

Ermöglicht es einem Handler, status- und Fehlerinformationen für alle Vorgänge bereitzustellen.

Syntax

HRESULT Advise(
  [in]  IFileOperationProgressSink *pfops,
  [out] DWORD                      *pdwCookie
);

Parameter

[in] pfops

Typ: IFileOperationProgressSink*

Zeiger auf ein IFileOperationProgressSink-Objekt, das für Status- status und Fehlerbenachrichtigungen verwendet werden soll.

[out] pdwCookie

Typ: DWORD*

Wenn diese Methode zurückgibt, verweist dieser Parameter 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 IFileOperation::Unadvise übergibt. Wenn der Aufruf von Advise fehlschlägt, ist dieser Wert bedeutungslos.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Mehrere einzelne Methoden haben die Möglichkeit, ihre eigenen Fortschrittssenken zu deklarieren, die gegenüber der hier festgelegten redundant sind. Sie werden verwendet, wenn Sie nur Status- und Fehlerinformationen für einen bestimmten Vorgang erhalten möchten.

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 (shobjidl.h einschließen)

Weitere Informationen

IFileOperation

IFileOperation::Unadvise