Méthode IVssExpressWriter ::CreateMetadata (vswriter.h)

Article
03/06/2024

Crée un objet de métadonnées express writer et retourne un pointeur d’interface IVssCreateExpressWriterMetadata vers celui-ci.

Syntaxe

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
);

Paramètres

[in] writerId

Identificateur global unique (GUID) de la classe writer.

[in] writerName

Chaîne de caractères larges terminée par null qui contient le nom de la classe writer. Cette chaîne n’est pas localisée.

[in] usageType

Valeur d’énumération VSS_USAGE_TYPE qui indique comment les données gérées par l’enregistreur sont utilisées sur le système hôte. Les seules valeurs valides pour ce paramètre sont VSS_UT_BOOTABLESYSTEMSTATE, VSS_UT_SYSTEMSERVICE et VSS_UT_USERDATA.

[in] versionMajor

Version principale de l’application writer. Pour plus d'informations, consultez la section Notes.

[in] versionMinor

Version mineure de l’application writer. Pour plus d'informations, consultez la section Notes.

[in] reserved

Ce paramètre est réservé à une utilisation système.

[out] ppMetadata

Pointeur vers une variable qui reçoit un pointeur d’interface IVssCreateExpressWriterMetadata vers les métadonnées de l’enregistreur express nouvellement créées.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Les paramètres versionMajor et versionMajor sont utilisés pour spécifier les numéros de version principale et secondaire de l’enregistreur conformément aux conventions VSS suivantes :

Le numéro de version mineure d’un writer doit être incrémenté d’un chaque fois qu’une version publiée de l’enregistreur contient des modifications mineures qui affectent l’interaction de l’enregistreur avec les demandeurs. Par exemple, une correction d’une spécification de fichier dans un QFE ou un Service Pack writer justifierait l’incrémentation du numéro de version mineure. Toutefois, une modification entre les versions bêta ou release candidate d’un writer ne justifierait pas la modification du numéro de version mineure.
Le numéro de version principale d’un writer doit être incrémenté d’un chaque fois qu’une version publiée de l’enregistreur contient une modification significative. Par exemple, si les données sauvegardées avec une nouvelle version d’un writer ne peuvent pas être restaurées à l’aide de la version précédente de l’enregistreur, le numéro de version principale du nouvel enregistreur doit être incrémenté.
Chaque fois que le numéro de version principale est incrémenté, le numéro de version secondaire doit être réinitialisé à zéro.

Si un writer ne spécifie pas de numéro de version, VSS affecte un numéro de version par défaut de 0,0.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vswriter.h

Voir aussi

CreateVssExpressWriter

IVssExpressWriter

Partager via