Metodo CVssWriterEx2::SetWriterFailureEx (vswriter.h)

Articolo
03/13/2024

Imposta informazioni sull'errore estese per indicare che il writer ha riscontrato un problema con la partecipazione a un'operazione VSS.

Sintassi

HRESULT SetWriterFailureEx(
  [in] HRESULT hrWriter,
  [in] HRESULT hrApplication,
  [in] LPCWSTR wszApplicationMessage
);

Parametri

[in] hrWriter

Codice di errore da restituire al richiedente.

Di seguito sono riportati i codici di errore che questo metodo può impostare.

Valore	Significato
S_OK	Il writer ha avuto successo.
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT	La copia shadow contiene solo un subset dei volumi necessari dal writer per eseguire correttamente il backup del componente dell'applicazione.
VSS_E_WRITERERROR_OUTOFRESOURCES	Il writer ha esaurito memoria o altre risorse di sistema. Il modo consigliato per gestire questo codice di errore consiste nell'attendere dieci minuti e quindi ripetere l'operazione, fino a tre volte.
VSS_E_WRITERERROR_TIMEOUT	L'operazione writer non è riuscita a causa di un timeout tra gli eventi Freeze e Thaw. Il modo consigliato per gestire questo codice di errore consiste nell'attendere dieci minuti e quindi ripetere l'operazione, fino a tre volte.
VSS_E_WRITERERROR_RETRYABLE	Il writer non è riuscito a causa di un errore che probabilmente non si verifica se è stato riavviato l'intero processo di backup, ripristino o copia shadow. Il modo consigliato per gestire questo codice di errore consiste nell'attendere dieci minuti e quindi ripetere l'operazione, fino a tre volte.
VSS_E_WRITERERROR_NONRETRYABLE	L'operazione writer non è riuscita a causa di un errore che potrebbe verificarsi se viene creata un'altra copia shadow. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
VSS_E_WRITERERROR_PARTIAL_FAILURE	Il writer segnala uno o più errori a livello di componente. Per segnalare gli errori, il writer deve usare il metodo IVssComponentEx2::SetFailure .

[in] hrApplication

Codice di errore aggiuntivo da restituire al richiedente. Questo parametro è facoltativo e,

[in] wszApplicationMessage

Stringa contenente un messaggio di errore per il richiedente da visualizzare all'utente finale. Il writer è responsabile della localizzazione di questa stringa se necessario prima di usarlo in questo metodo. Questo parametro è facoltativo e può essere NULL o una stringa vuota.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo non può essere chiamato da CVssWriter::OnIdentify o CVssWriterEx::OnIdentifyEx.

Per segnalare errori a livello di componente, i writer devono usare il metodo IVssComponentEx2::SetFailure .

Se il gestore eventi di un writer ,ad esempio CVssWriter::OnFreeze, chiama questo metodo, deve farlo nello stesso thread che ha chiamato il gestore eventi. Per altre informazioni, vedere Gestione eventi writer.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vswriter.h (include Vss.h, VsWriter.h)
Libreria	VssApi.lib

Vedi anche

CVssWriter::SetWriterFailure

CVssWriterEx2

IVssBackupComponentsEx3::GetWriterStatusEx

Condividi tramite