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 |