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

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
);

[in] psi

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.

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.

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)