Share via


Metodo IVssComponent::GetPreRestoreFailureMsg (vswriter.h)

Il metodo GetPreRestoreFailureMsg recupera il messaggio di errore generato da un writer durante la gestione dell'evento PreRestore , se IVssComponent::SetPreRestoreFailureMsg impostato uno.

Un writer o un richiedente può chiamare questo metodo.

Sintassi

HRESULT GetPreRestoreFailureMsg(
  [out] BSTR *pbstrPreRestoreFailureMsg
);

Parametri

[out] pbstrPreRestoreFailureMsg

Stringa contenente il messaggio di errore che descrive un errore che si è verificato durante l'elaborazione dell'evento PreRestore .

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Valore Significato
S_OK
Restituito correttamente il valore dell'attributo.
S_FALSE
Nessun messaggio di errore PreRestore è stato disponibile per il recupero.
E_INVALIDARG
Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY
Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_INVALID_XML_DOCUMENT
Il documento XML non è valido. Controllare il registro eventi per informazioni dettagliate. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.

Commenti

Il chiamante deve liberare la memoria contenuta dal parametro pbstrPreRestoreFailureMsg chiamando SysFreeString.

Se SetPreRestoreFailureMsg non è stato usato per impostare un messaggio di errore PreRestore , GetPreRestoreFailureMsg restituisce S_FALSE.

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione vswriter.h (include Vss.h, VsWriter.h)
Libreria VssApi.lib

Vedi anche

IVssComponent

IVssComponent::GetPostRestoreFailureMsg

IVssComponent::SetPostRestoreFailureMsg

IVssComponent::SetPreRestoreFailureMsg