IVssBackupComponentsEx3::GetWriterStatusEx-Methode (vsbackup.h)
Gibt erweiterte status Informationen für den angegebenen Writer zurück.
Syntax
HRESULT GetWriterStatusEx(
[in] UINT iWriter,
[out] VSS_ID *pidInstance,
[out] VSS_ID *pidWriter,
[out] BSTR *pbstrWriter,
[out] VSS_WRITER_STATE *pnStatus,
[out] HRESULT *phrFailureWriter,
[out, optional] HRESULT *phrApplication,
[out, optional] BSTR *pbstrApplicationMessage
);
Parameter
[in] iWriter
Der Index des Writers, dessen Metadaten abgerufen werden sollen. Der Wert dieses Parameters ist eine ganze Zahl von 0 bis einschließlich n–1, wobei n die Gesamtzahl der Writer im aktuellen System ist. Der Wert von n wird von der IVssBackupComponents::GetWriterStatusCount-Methode zurückgegeben.
[out] pidInstance
Die Adresse einer vom Aufrufer zugeordneten Variablen, die den instance Bezeichner des Writers empfängt. Dieser Parameter ist erforderlich und darf nicht NULL sein.
[out] pidWriter
Die Adresse einer vom Aufrufer zugeordneten Variablen, die den Bezeichner für die Writer-Klasse empfängt. Dieser Parameter ist erforderlich und darf nicht NULL sein.
[out] pbstrWriter
Die Adresse einer vom Aufrufer zugeordneten Variablen, die eine Zeichenfolge mit dem Namen des angegebenen Writers empfängt. Dieser Parameter ist erforderlich und darf nicht NULL sein.
[out] pnStatus
Die Adresse einer vom Aufrufer zugeordneten Variablen, die einen VSS_WRITER_STATE Enumerationswert empfängt. Dieser Parameter ist erforderlich und darf nicht NULL sein.
[out] phrFailureWriter
Die Adresse einer vom Aufrufer zugeordneten Variablen, die den HRESULT-Fehlercode empfängt, den der Writer für den hrWriter-Parameter der CVssWriterEx2::SetWriterFailureEx-Methode zurückgegeben hat.
Im Folgenden werden die unterstützten Werte aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Der Schreiber war erfolgreich. |
|
Die Schattenkopie enthält nur eine Teilmenge der Volumes, die der Writer benötigt, um die Anwendungskomponente ordnungsgemäß zu sichern. |
|
Dem Writer ist der Arbeitsspeicher oder andere Systemressourcen nicht mehr verfügbar. Die empfohlene Möglichkeit, diesen Fehlercode zu behandeln, besteht darin, zehn Minuten zu warten und den Vorgang dann bis zu dreimal zu wiederholen. |
|
Der Writer-Vorgang ist aufgrund eines Timeouts zwischen den Freeze- und Thaw-Ereignissen fehlgeschlagen. Die empfohlene Möglichkeit, diesen Fehlercode zu behandeln, besteht darin, zehn Minuten zu warten und den Vorgang dann bis zu dreimal zu wiederholen. |
|
Fehler beim Writer aufgrund eines Fehlers, der wahrscheinlich nicht auftreten würde, wenn der gesamte Erstellungsprozess für Sicherung, Wiederherstellung oder Schattenkopie neu gestartet wurde. Die empfohlene Möglichkeit, diesen Fehlercode zu behandeln, besteht darin, zehn Minuten zu warten und den Vorgang dann bis zu dreimal zu wiederholen. |
|
Der Writervorgang ist aufgrund eines Fehlers fehlgeschlagen, der möglicherweise erneut auftritt, wenn eine weitere Schattenkopie erstellt wird. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
Der Writer reagiert nicht. |
|
Die Writer-status ist für mindestens einen Writer nicht verfügbar. Ein Writer hat möglicherweise die maximale Anzahl verfügbarer Sicherungs- und Wiederherstellungssitzungen erreicht. |
|
Der Writer meldet mindestens einen Fehler auf Komponentenebene. Um die Fehler abzurufen, muss der Anforderer die IVssComponentEx2::GetFailure-Methode verwenden. |
[out, optional] phrApplication
Die Adresse einer vom Aufrufer zugeordneten Variablen, die den Rückgabecode empfängt, den der Writer für den hrApplication-Parameter der CVssWriterEx2::SetWriterFailureEx-Methode übergeben hat. Dieser Parameter ist optional und kann NULL sein.
[out, optional] pbstrApplicationMessage
Die Adresse einer Variablen, die die Anwendungsfehlermeldung empfängt, die der Writer für den wszApplicationMessage-Parameter der SetWriterFailureEx-Methode übergeben hat. Dieser Parameter ist optional und kann NULL sein.
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Die status des angegebenen Writer wurde erfolgreich zurückgegeben. Beachten Sie, dass der Wert des parameters phrFailureWriter überprüft werden muss, um zu überprüfen, ob der Writer erfolgreich war. Die Writerfehlercodes können zu den in VsWriter.h und in Writerfehlern und Vetoes aufgeführten Gehören. |
|
Der Parameter pnStatus, pidWriter, pbstrWriter oder pidInstance ist NULL. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht innerhalb der richtigen Sequenz aufgerufen. |
|
Der Parameter iWriter gibt einen Writer an, der nicht vorhanden ist. |
Hinweise
Ein Anforderer muss den asynchronen Vorgang IVssBackupComponents::GatherWriterStatus aufrufen und warten, bis er abgeschlossen ist, bevor IVssBackupComponentsEx3::GetWriterStatusEx aufgerufen wird.
Wenn diese Methode VSS_E_WRITERERROR_PARTIAL_FAILURE zurückgibt, sollte der Anforderer die IVssComponentEx2::GetFailure-Methode verwenden, um die Fehler auf Komponentenebene abzurufen.
Wenn der Aufrufer den Zugriff auf die von dieser Methode zurückgegebenen status Informationen abgeschlossen hat, sollte er SysFreeString aufrufen, um den Arbeitsspeicher freizugeben, der von den Parametern pbstrWriter und pbstrApplicationMessage gehalten wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h) |
Weitere Informationen
CVssWriterEx2::SetWriterFailureEx