ITransferAdviseSink::FileFailure-Methode (shobjidl_core.h)

Wird aufgerufen, wenn ein Fehler auftritt und benutzerinteraktion erforderlich ist.

Syntax

HRESULT FileFailure(
  [in]      IShellItem *psi,
  [in]      LPCWSTR    pszItem,
  [in]      HRESULT    hrError,
  [in, out] LPWSTR     pszRename,
  [in]      ULONG      cchRename
);

Parameter

[in] psi

Typ: IShellItem*

Das IShellItem,bei dem der Vorgang fehlgeschlagen ist.

[in] pszItem

Typ: LPCWSTR

Optional. Ein Zeiger auf einen Puffer mit NULL-Beendigung, der den Namen der Datei enthält. Wenn dieser Wert NULL ist, wird der vom psi-Parameter angegebene Name verwendet.

[in] hrError

Typ: HRESULT

Der durch den Fehler generierte Fehlercode. Dieser Fehler muss vom Kopiermodul behandelt werden.

[in, out] pszRename

Typ: LPWSTR

Optional. Wenn diese Methode zurückgibt, enthält einen Zeiger auf einen Puffer mit NULL-Beendigung, der einen neuen Namen für die Datei enthält. Der Name darf die Länge cchRename nicht überschreiten. Wenn dieser Parameter NULL ist, ist keine Umbenennungsoption verfügbar.

[in] cchRename

Typ: ULONG

Die Größe des Puffers pszRename in Zeichen.

Rückgabewert

Typ: HRESULT

Alle anderen HRESULT-Ergebnisse sollten an den aufrufenden Prozess zurückgegeben werden. Wenn der Fehler nicht behandelt wird, sollte der Rückgabewert hrError sein.

Rückgabecode Beschreibung
COPYENGINE_S_USER_RETRY
Der Benutzer hat auf Wiederholen geklickt. Der Handler sollte den Dateivorgang wiederholen.
COPYENGINE_E_USERCANCELLED
Der Benutzer hat auf Abbrechen geklickt. Der gesamte Kopierauftrag wird beendet. Der Handler sollte diesen Code an das Kopiermodul zurückgeben.
COPYENGINE_S_USER_IGNORED
Der Benutzer hat auf Ignorieren geklickt. Der Handler sollte das Erstellen des Elements überspringen und diesen Code an das Kopiermodul zurückgeben.

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)