CVssWriterEx2::GetSessionId-Methode (vswriter.h)

Gibt den Sitzungsbezeichner des Writers zurück.

Syntax

HRESULT GetSessionId(
  [out] VSS_ID *idSession
);

Parameter

[out] idSession

Ein Zeiger auf eine Variable, die den Sitzungsbezeichner empfängt.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der Sitzungsbezeichner ist ein undurchsichtiger Wert, der eine Sicherungs- oder Wiederherstellungssitzung eindeutig identifiziert. Es wird verwendet, um die aktuelle Sitzung zwischen mehreren parallelen Sicherungs- oder Wiederherstellungssitzungen zu unterscheiden.

Als bewährte Methode sollten Autoren und Anforderer die Sitzungs-ID in alle Diagnose Nachrichten einschließen, die für die Ereignisprotokollierung und -ablaufverfolgung verwendet werden.

Wenn der Ereignishandler eines Writers (z. B . CVssWriter::OnFreeze) diese Methode aufruft, muss er dies im selben Thread tun, der den Ereignishandler aufgerufen hat. Weitere Informationen finden Sie unter Writer-Ereignisbehandlung.

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	vswriter.h (enthalten Vss.h, VsWriter.h)
Bibliothek	VssApi.lib

Weitere Informationen

CVssWriterEx2

IVssBackupComponentsEx3::GetSessionId