IFileOperation::Advise-Methode (shobjidl_core.h)
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) |