ITransferAdviseSink::P ropertyFailure-Methode (shobjidl_core.h)

  • Artikel

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

Syntax

HRESULT PropertyFailure(
  [in] IShellItem        *psi,
  [in] const PROPERTYKEY *pkey,
  [in] HRESULT           hrError
);

Parameter

[in] psi

Typ: IShellItem*

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

[in] pkey

Typ: const PROPERTYKEY*

Ein Wert, der der verloren gehenden Eigenschaft entspricht. Ein NULL-Wert gibt an, dass alle Eigenschaften verloren gegangen sind.

[in] hrError

Typ: HRESULT

Der durch den Fehler 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

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)