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
S_OK
Das Writer-Objekt wurde erfolgreich initialisiert.
S_FALSE
Das Writer-Objekt konnte nicht initialisiert werden. die VSS Writer-Infrastruktur war inaktiv, da Windows sich im abgesicherten Modus befand oder eingerichtet wurde.
E_ACCESSDENIED
Der Aufrufer ist kein Administrator.
E_INVALIDARG
Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
Der Aufrufer verfügt nicht über 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.

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

Weitere Informationen

CVssWriter

CVssWriter::OnAbort

VSS_ALTERNATE_WRITER_STATE

VSS_APPLICATION_LEVEL

VSS_ID

VSS_SOURCE_TYPE

VSS_USAGE_TYPE