CVssWriter::Initialize-Methode (vswriter.h)
Initialisiert ein CVssWriter-Objekt und ermöglicht es einer Writer-Anwendung, mit VSS zu interagieren.
Initialize ist eine öffentliche Methode, die von der CVssWriter-Basisklasse implementiert wird.
Syntax
HRESULT Initialize(
[in] VSS_ID WriterId,
[in] LPCWSTR wszWriterName,
[in] VSS_USAGE_TYPE ut,
[in] VSS_SOURCE_TYPE st,
[in] VSS_APPLICATION_LEVEL nLevel,
[in] DWORD dwTimeoutFreeze,
[in] VSS_ALTERNATE_WRITER_STATE aws,
[in] bool bIOThrottlingOnly,
[in] LPCWSTR wszWriterInstanceName
);
Parameter
[in] WriterId
Der globally unique Identifier (GUID) der Writer-Klasse.
[in] wszWriterName
Eine mit NULL beendete breite Zeichenfolge, die den Namen des Writer enthält. Diese Zeichenfolge ist nicht lokalisiert.
[in] ut
Ein VSS_USAGE_TYPE Enumerationswert, der angibt, wie die vom Writer verwalteten Daten auf dem Hostsystem verwendet werden.
[in] st
Ein VSS_SOURCE_TYPE Enumerationswert, der den Typ der vom Writer verwalteten Daten angibt.
[in] nLevel
Ein VSS_APPLICATION_LEVEL Enumerationswert, der die Anwendungsebene angibt, auf der der Writer eine Freeze-Ereignisbenachrichtigung empfängt.
Der Standardwert für diesen Parameter ist VSS_APP_FRONT_END.
[in] dwTimeoutFreeze
Die maximal zulässige Zeit in Millisekunden zwischen dem Empfang einer Freeze-Ereignisbenachrichtigung durch einen Schreiber und dem Empfang einer übereinstimmenden Thaw-Ereignisbenachrichtigung von VSS. Nach Ablauf des Timeouts wird die CVssWriter::OnAbort-Methode des Writers automatisch aufgerufen.
Der Standardwert für diesen Parameter ist 60000.
[in] aws
Ein VSS_ALTERNATE_WRITER_STATE Enumerationswert, der angibt, ob der Writer über einen alternativen Writer verfügt.
Der Standardwert für diesen Parameter ist VSS_AWS_NO_ALTERNATE_WRITER. Der Aufrufer sollte diesen Standardwert nicht außer Kraft setzen. Dieser Parameter ist für die zukünftige Verwendung reserviert.
[in] bIOThrottlingOnly
Legen Sie diesen Parameter auf true fest, wenn E/A-Einschränkungsmethoden aktiviert sind, oder andernfalls false .
Der Standardwert für diesen Parameter ist false. Der Aufrufer sollte diesen Standardwert nicht außer Kraft setzen. Dieser Parameter ist für die zukünftige Verwendung reserviert.
[in] wszWriterInstanceName
Eine mit NULL beendete breite Zeichenfolge, die den Writer instance Namen enthält.
Der Standardwert für diesen Parameter ist NULL. Wenn der Writer über mehrere Instanzen verfügt und Wiederherstellungsereignisse erfordert, ist dieser Parameter erforderlich und kann nicht NULL sein. Ausführliche Informationen finden Sie im folgenden Abschnitt mit den Anmerkungen.
Windows Server 2003 und Windows XP: Vor Windows Server 2003 mit SP1 ist dieser Parameter für die Systemverwendung reserviert, und der Aufrufer sollte den Standardwert nicht überschreiben.
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Das Writer-Objekt wurde erfolgreich initialisiert. |
|
Das Writer-Objekt konnte nicht initialisiert werden. die VSS Writer-Infrastruktur war inaktiv, da Windows sich im abgesicherten Modus befand oder eingerichtet wurde. |
|
Der Aufrufer ist kein Administrator. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
|
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. |
Hinweise
VSS weist jedem instance einer Writeranwendung eine eindeutige Writer-instance-ID zu. Wenn mehrere instance gleichzeitig auf dem System vorhanden sind (z. B. wenn mehrere SQL-Server auf einem System ausgeführt werden), wird jeder Writer durch die Kombination seiner Writer-Klassen-ID und seiner Writer-instance-ID eindeutig identifiziert.
Der wszWriterInstanceName-Parameter ermöglicht es einem Writer mit mehreren instance, einen persistenten Namen für jeden Writer instance als lesbare Zeichenfolge anzugeben. Dieser Name muss für alle Instanzen des Writers im System eindeutig sein. Wenn ein Writer über mehrere Instanzen verfügt und Wiederherstellungsereignisse erfordert, muss er eine Nicht-NULL-Zeichenfolge für diesen Parameter angeben. VSS verwendet den instance Namen, um Autoren mit mehreren instance ordnungsgemäß wiederherzustellen.
Anforderungen
| 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 |