Condividi tramite

Metodo ITransferAdviseSink::FileFailure (shobjidl_core.h)

  • Articolo

Chiamato quando si verifica un errore e l'interazione dell'utente è necessaria.

Sintassi

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

Parametri

[in] psi

Tipo: IShellItem*

IShellItem in cui l'operazione non è riuscita.

[in] pszItem

Tipo: LPCWSTR

facoltativo. Puntatore a un buffer con terminazione null contenente il nome del file. Se questo valore è NULL, viene usato il nome specificato dal parametro psi .

[in] hrError

Tipo: HRESULT

Codice di errore generato dall'errore. Questo errore deve essere gestito dal motore di copia.

[in, out] pszRename

Tipo: LPWSTR

facoltativo. Quando questo metodo restituisce, contiene un puntatore a un buffer con terminazione null contenente un nuovo nome per il file. Il nome non può superare la lunghezza cchRename. Se questo parametro è NULL, non sarà disponibile alcuna opzione per rinominare.

[in] cchRename

Tipo: ULONG

Dimensioni del buffer pszRename , in caratteri.

Valore restituito

Tipo: HRESULT

Qualsiasi altro HRESULT deve essere restituito al processo di chiamata. Se l'errore non viene gestito, il valore restituito deve essere hrError.

Codice restituito Descrizione
COPYENGINE_S_USER_RETRY
 L'utente ha fatto clic su Riprova. Il gestore deve ripetere l'operazione di file.
COPYENGINE_E_USERCANCELLED
 L'utente ha fatto clic su Annulla. L'intero processo di copia viene terminato. Il gestore deve restituire il codice al motore di copia.
COPYENGINE_S_USER_IGNORED
 L'utente ha fatto clic su Ignora. Il gestore deve ignorare la creazione dell'elemento e restituire nuovamente il codice al motore di copia.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl_core.h (include Shobjidl.h)