IVssExpressWriter::CreateMetadata-Methode (vswriter.h)

Artikel
08/27/2023

Erstellt ein Express Writer-Metadatenobjekt und gibt einen IVssCreateExpressWriterMetadata-Schnittstellenzeiger darauf zurück.

Syntax

HRESULT CreateMetadata(
  [in]  VSS_ID                          writerId,
  [in]  LPCWSTR                         writerName,
  [in]  VSS_USAGE_TYPE                  usageType,
  [in]  DWORD                           versionMajor,
  [in]  DWORD                           versionMinor,
  [in]  DWORD                           reserved,
  [out] IVssCreateExpressWriterMetadata **ppMetadata
);

Parameter

[in] writerId

Der globally unique Identifier (GUID) der Writer-Klasse.

[in] writerName

Eine mit NULL beendete breite Zeichenfolge, die den Namen der Writer-Klasse enthält. Diese Zeichenfolge ist nicht lokalisiert.

[in] usageType

Ein VSS_USAGE_TYPE Enumerationswert, der angibt, wie die vom Writer verwalteten Daten auf dem Hostsystem verwendet werden. Die einzigen gültigen Werte für diesen Parameter sind VSS_UT_BOOTABLESYSTEMSTATE, VSS_UT_SYSTEMSERVICE und VSS_UT_USERDATA.

[in] versionMajor

Die Hauptversion der Writer-Anwendung. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

[in] versionMinor

Die Nebenversion der Writer-Anwendung. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

[in] reserved

Dieser Parameter ist für die Systemverwendung reserviert.

[out] ppMetadata

Ein Zeiger auf eine Variable, die einen IVssCreateExpressWriterMetadata-Schnittstellenzeiger auf die neu erstellten Express Writer-Metadaten empfängt.

Rückgabewert

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

Hinweise

Die Parameter versionMajor und versionMajor werden verwendet, um die Haupt- und Nebenversionsnummern des Writers gemäß den folgenden VSS-Konventionen anzugeben:

Die Nebenversionsnummer eines Writers sollte um eine erhöht werden, wenn eine veröffentlichte Version des Writer geringfügige Änderungen enthält, die sich auf die Interaktion des Schreibers mit den Anforderern auswirken. Beispielsweise würde eine Korrektur an einer Dateispezifikation in einem Writer-QFE oder Service Pack die Erhöhung der Nebenversionsnummer rechtfertigen. Eine Änderung zwischen Beta- oder Release candidate-Versionen eines Writers würde jedoch nicht die Änderung der Nebenversionsnummer rechtfertigen.
Die Hauptversionsnummer eines Writers sollte um eine erhöht werden, wenn eine veröffentlichte Version des Writers eine wesentliche Änderung enthält. Wenn beispielsweise Daten, die mit einer neuen Version eines Writer gesichert werden, nicht mit der vorherigen Version des Writers wiederhergestellt werden können, sollte die Hauptversionsnummer des neuen Writers erhöht werden.
Wenn die Hauptversionsnummer erhöht wird, sollte die Nebenversionsnummer auf 0 zurückgesetzt werden.

Wenn ein Writer keine Versionsnummer angibt, weist VSS die Standardversionsnummer 0.0 zu.

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

Weitere Informationen

CreateVssExpressWriter

IVssExpressWriter

Freigeben über