CVssWriterEx::SubscribeEx-Methode (vswriter.h)

Bewirkt, dass der Writer VSS-Ereignisse abonniert.

Syntax

HRESULT SubscribeEx(
  [in] DWORD dwUnsubscribeTimeout,
  [in] DWORD dwEventFlags
);

Parameter

[in] dwUnsubscribeTimeout

Die Zeitdauer in Millisekunden, die die Methode wartet, bevor ein Timeout auftritt.

[in] dwEventFlags

Eine Bitmaske mit VSS_SUBSCRIBE_MASK Werten, die die Ereignisse angeben, über die VSS den Writer benachrichtigen soll.

Der Standardwert für dieses Argument ist (VSS_SM_BACKUP_EVENTS_FLAG | VSS_SM_RESTORE_EVENTS_FLAG). Derzeit sollte der Aufrufer den Standardwert nicht überschreiben.

Dieser Parameter ist für die zukünftige Verwendung reserviert.

Rückgabewert

Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.

Wert Bedeutung
S_OK
Der Writer hat erfolgreich abonniert.
E_ACCESSDENIED
Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator.
E_OUTOFMEMORY
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_UNEXPECTED
Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet.

VSS_E_WRITER_ALREADY_SUBSCRIBED
Der Writer hat diese Methode zuvor aufgerufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vswriter.h (enthalten Vss.h, VsWriter.h)
Bibliothek VssApi.lib

Weitere Informationen

CVssWriter::Subscribe

CVssWriterEx