Compartilhar via

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

  • Artigo

Cria um objeto de metadados de gravador expresso e retorna um ponteiro de interface IVssCreateExpressWriterMetadata para ele.

Sintaxe

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

Parâmetros

[in] writerId

O GUID (identificador global exclusivo) da classe de gravador.

[in] writerName

Uma cadeia de caracteres largos terminada em nulo que contém o nome da classe de gravador. Essa cadeia de caracteres não está localizada.

[in] usageType

Um VSS_USAGE_TYPE valor de enumeração que indica como os dados gerenciados pelo gravador são usados no sistema host. Os únicos valores válidos para esse parâmetro são VSS_UT_BOOTABLESYSTEMSTATE, VSS_UT_SYSTEMSERVICE e VSS_UT_USERDATA.

[in] versionMajor

A versão principal do aplicativo gravador. Para obter mais informações, consulte a seção Comentários.

[in] versionMinor

A versão secundária do aplicativo gravador. Para obter mais informações, consulte a seção Comentários.

[in] reserved

Esse parâmetro é reservado para uso do sistema.

[out] ppMetadata

Um ponteiro para uma variável que recebe um ponteiro de interface IVssCreateExpressWriterMetadata para os metadados do gravador expresso recém-criado.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Os parâmetros versionMajor e versionMajor são usados para especificar os números de versão principal e secundária do gravador de acordo com as seguintes convenções vss:

  • O número de versão secundária de um gravador deve ser incrementado por um sempre que uma versão lançada do gravador contiver pequenas alterações que afetam a interação do gravador com os solicitantes. Por exemplo, uma correção em uma especificação de arquivo em um QFE de gravador ou service pack justificaria o incremento do número de versão secundária. No entanto, uma alteração entre versões beta ou release candidate de um gravador não justificaria a alteração do número de versão secundária.
  • O número de versão principal de um gravador deve ser incrementado por um sempre que uma versão lançada do gravador contiver uma alteração significativa. Por exemplo, se os dados com backup com uma nova versão de um gravador não puderem ser restaurados usando a versão anterior do gravador, o número de versão principal do novo gravador deverá ser incrementado.
  • Sempre que o número da versão principal for incrementado, o número de versão secundária deverá ser redefinido para zero.
Se um gravador não especificar um número de versão, o VSS atribuirá um número de versão padrão de 0.0.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vswriter.h

Confira também

CreateVssExpressWriter

IVssExpressWriter