Share via

ITransferAdviseSink::SubStreamFailure-Methode (shobjidl_core.h)

  • Artikel

Wird aufgerufen, wenn ein Fehler auftritt, der sekundäre Datenströme umfasst und eine Benutzerinteraktion erforderlich ist.

Syntax

HRESULT SubStreamFailure(
  [in] IShellItem *psi,
  [in] LPCWSTR    pszStreamName,
  [in] HRESULT    hrError
);

Parameter

[in] psi

Typ: IShellItem*

Ein Zeiger auf das IShellItem, das den Fehler verursacht hat.

[in] pszStreamName

Typ: LPCWSTR

Der Name der Daten, die im Vorgang verloren gehen.

[in] hrError

Typ: HRESULT

Der generierte Fehlercode. Sie muss von der Kopier-Engine verarbeitet werden.

Rückgabewert

Typ: HRESULT

Alle anderen HRESULT-Ergebnisse sollten übergeben werden. Wenn der Fehler nicht behandelt wird, sollte der Rückgabewert hrError sein.

Rückgabecode Beschreibung
COPYENGINE_S_USERRETRY
 Der Handler sollte den Dateivorgang wiederholen.
COPYENGINE_S_USERRETRYWITHNEWNAME
 Der Handler sollte den Dateivorgang mithilfe des im Puffer pszRename zurückgegebenen Namens wiederholen.
COPYENGINE_S_OVERWRITE
 Der Benutzer hat angegeben, dass der Handler die vorhandene Datei überschreiben soll.
COPYENGINE_S_RETRYWITHOUTSECURITY
 Der Benutzer hat angegeben, dass der Handler den Vorgang ohne sicherheitsdeskriptor erneut versuchen soll.
COPYENGINE_E_USERCANCELLED
 Der Benutzer hat auf Abbrechen geklickt. Der gesamte Kopierauftrag wird beendet. Der Handler sollte diesen Code an das Kopiermodul zurückgeben.

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)