Metodo IVssComponentEx2::GetFailure (vswriter.h)
I richiedenti VSS chiamano questo metodo per recuperare gli errori a livello di componente segnalati dai writer.
Sintassi
HRESULT GetFailure(
[out] HRESULT *phr,
[out] HRESULT *phrApplication,
[out] BSTR *pbstrApplicationMessage,
[out] DWORD *pdwReserved
);
Parametri
[out] phr
Indirizzo di una variabile allocata dal chiamante che riceve il codice di errore HRESULT passato dal writer per il parametro hr del metodo IVssComponentEx2::SetFailure . Questo parametro è obbligatorio e non può essere NULL.
Di seguito sono riportati i valori supportati.
| Valore | Significato |
|---|---|
|
Il writer ha avuto esito positivo. |
|
La copia shadow contiene solo un subset dei volumi necessari al writer per eseguire correttamente il backup del componente dell'applicazione. |
|
Il writer ha esaurito la 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. |
|
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. |
|
Il writer non è riuscito a causa di un errore che probabilmente non si verificherebbe se l'intero processo di backup, ripristino o creazione della copia shadow è stato riavviato. Il modo consigliato per gestire questo codice di errore consiste nell'attendere dieci minuti e quindi ripetere l'operazione, fino a tre volte. |
|
L'operazione del 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. |
|
Il writer non risponde. |
|
Lo stato del writer non è disponibile per uno o più writer. Un writer può aver raggiunto il numero massimo di sessioni di backup e ripristino disponibili. |
[out] phrApplication
Indirizzo di una variabile allocata dal chiamante che riceve il codice restituito passato dal writer per il parametro hrApplication del metodo SetFailure . Questo parametro è obbligatorio e non può essere NULL.
[out] pbstrApplicationMessage
Indirizzo di una variabile allocata dal chiamante che riceve il messaggio di errore dell'applicazione che il writer ha passato per il parametro wszApplicationMessage del metodo SetFailure . Questo parametro è obbligatorio e non può essere NULL.
[out] pdwReserved
Indirizzo di una variabile DWORD allocata dal chiamante. Questo parametro è riservato per uso futuro, ma è obbligatorio e non può essere NULL.
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
È stato restituito lo stato del writer specificato. Si noti che il valore del parametro phrFailureWriter deve essere controllato per verificare che il writer sia riuscito. I codici di errore del writer possono essere tra quelli elencati in VsWriter.h e in Errori e veto del writer. |
|
Il parametro phr, phrApplication, pbstrApplicationMessage o pdwReserved è NULL. |
|
Il chiamante non è in memoria o in altre risorse di sistema. |
|
L'oggetto componenti di backup non viene inizializzato, questo metodo è stato chiamato durante un'operazione di ripristino oppure questo metodo non è stato chiamato all'interno della sequenza corretta. |
Commenti
Al termine dell'accesso alle informazioni sullo stato restituite da questo metodo, il chiama SysFreeString per liberare la memoria contenuta nel parametro pbstrApplicationMessage .
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 |