CVssWriter::OnIdentify-Methode (vswriter.h)

Die OnIdentify-Methode wird von einem Writer aufgerufen, nachdem ein Identify-Ereignis empfangen wurde.

OnIdentify ist eine virtuelle Methode. Sie wird von der CVssWriter-Basisklasse implementiert, kann aber von abgeleiteten Klassen überschrieben werden.

Syntax

bool OnIdentify(
  [in] IVssCreateWriterMetadata *pMetadata
);

Parameter

[in] pMetadata

Ein Zeiger auf ein IVssCreateWriterMetadata-Objekt , das zum Erstellen der Metadaten des Writers verwendet wird.

Rückgabewert

Wie von der Basisklasse implementiert, gibt OnIdentify immer true zurück.

Jede andere Implementierung dieser Methode muss true zurückgeben, außer im Fall eines schwerwiegenden Fehlers. Wenn ein schwerwiegender Fehler auftritt, sollte die Methode false zurückgeben.

In allen Fällen, wenn ein Fehler auftritt, einschließlich nicht schwerwiegender Fehler, sollte die Methode einen detaillierten Eintrag in das Ereignisprotokoll schreiben, um den genauen Grund für den Fehler zu melden.

Hinweise

Die Standardimplementierung dieser Methode durch die CVssWriter-Basisklasse gibt true zurück, ohne einen anderen Vorgang auszuführen.

Writer sollten niemals eine Ausnahme von dieser Methode oder einer anderen CVssWriter(Ex)::OnXxx-Rückrufmethode auslösen.

Writer sollten niemals die CVssWriter::SetWriterFailure-Methode aus der OnIdentify - oder CVssWriterEx::OnIdentifyEx-Methode aufrufen.

Wenn diese Methode die CVssWriterEx2::GetSessionId-Methode aufruft, muss dies im selben Thread erfolgen, der diese Methode aufgerufen hat. Weitere Informationen finden Sie unter Writer-Ereignisbehandlung.

Als Reaktion auf ein von einer anderen Anwendung generiertes Identify-Ereignis erstellt ein Writer den OnIdentify-Handler , um ein Writer-Metadatendokument zu erstellen, das Informationen zu den Komponenten enthält, die er mithilfe der IVssCreateWriterMetadata-Schnittstelle verwaltet.

Die Anwendung, die das Identify-Ereignis generiert hat, ruft dann das Writer-Metadatendokument ab und untersucht die Komponenteninformationen des Writers mithilfe der IVssExamineWriterMetadata-Schnittstelle .

Vor den Ereignissen, aus denen eine Sicherungs- oder Wiederherstellungssequenz besteht, ist ein Identify-Ereignis erforderlich. Daher wird OnIdentify wahrscheinlich am häufigsten aufgerufen, um ein Identify-Ereignis als Reaktion auf den Aufruf eines Anforderers an IVssBackupComponents::GatherWriterMetadata im Rahmen eines Sicherungs- oder Wiederherstellungsvorgangs zu behandeln.

Ein Identify-Ereignis ist jedoch nicht selbst Teil der Ereignissequenz, aus der eine Sicherung oder Wiederherstellung besteht, und der VSS-Dienst verhindert seine Generierung nicht, auch wenn eine Sicherungs- oder Wiederherstellungssequenz ausgeführt wird. Für instance verwenden VSS-Verwaltungsanwendungen das Identify-Ereignis, um den Zustand der Autoren im System zu bestimmen und anzuzeigen.

In diesem Fall sollten Autoren ihre Implementierung von OnIdentify niemals wie folgt verwenden:

• Als Beginn der Behandlung einer Sicherung oder Wiederherstellung
• So legen Sie Informationen zum Zustand des Schreibers fest oder verwalten sie

Weitere Informationen zu Writerinteraktionen mit Ereignissen finden Sie unter Writer-Ereignisbehandlung .

Der Lebenszyklus des an OnIdentifyübergebenen IVssCreateWriterMetadata-Objekts wird von der VSS-Infrastruktur verwaltet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vswriter.h (einschließlich Vss.h, VsWriter.h)
Bibliothek	VssApi.lib

Weitere Informationen

CVssWriter

IVssBackupComponents::GatherWriterMetadata

IVssCreateWriterMetadata