Metodo IVssExpressWriter::CreateMetadata (vswriter.h)

Articolo
03/08/2023

Crea un oggetto metadati express writer e restituisce un puntatore all'interfaccia IVssCreateExpressWriterMetadata .

Sintassi

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

Parametri

[in] writerId

Identificatore univoco globale (GUID) della classe writer.

[in] writerName

Stringa di caratteri wide con terminazione Null contenente il nome della classe writer. Questa stringa non è localizzata.

[in] usageType

Valore di enumerazione VSS_USAGE_TYPE che indica come vengono usati i dati gestiti dal writer nel sistema host. Gli unici valori validi per questo parametro sono VSS_UT_BOOTABLESYSTEMSTATE, VSS_UT_SYSTEMSERVICE e VSS_UT_USERDATA.

[in] versionMajor

Versione principale dell'applicazione writer. Per altre informazioni, vedere la sezione Osservazioni.

[in] versionMinor

Versione secondaria dell'applicazione writer. Per altre informazioni, vedere la sezione Osservazioni.

[in] reserved

Questo parametro è riservato per l'uso del sistema.

[out] ppMetadata

Puntatore a una variabile che riceve un puntatore all'interfaccia IVssCreateExpressWriterMetadata ai metadati del writer express appena creato.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

I parametri versionMajor e versionMajor vengono usati per specificare i numeri di versione principale e secondaria del writer in base alle convenzioni VSS seguenti:

Il numero di versione secondaria di un writer deve essere incrementato di uno ogni volta che una versione rilasciata del writer contiene modifiche secondarie che influiscono sull'interazione del writer con i richiedenti. Ad esempio, una correzione a una specifica di file in un QFE o service pack writer giustifica l'incremento del numero di versione secondaria. Tuttavia, una modifica tra le versioni beta o release candidate di un writer non giustifica la modifica del numero di versione secondaria.
Il numero di versione principale di un writer deve essere incrementato di uno ogni volta che una versione rilasciata del writer contiene una modifica significativa. Ad esempio, se non è possibile ripristinare i dati di cui è stato eseguito il backup con una nuova versione di un writer usando la versione precedente del writer, è necessario incrementare il numero di versione principale del nuovo writer.
Ogni volta che viene incrementato il numero di versione principale, il numero di versione secondaria deve essere reimpostato su zero.

Se un writer non specifica un numero di versione, VSS assegnerà un numero di versione predefinito pari a 0.0.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vswriter.h

Vedi anche

CreateVssExpressWriter

IVssExpressWriter

Condividi tramite