Compartir a través de

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

  • Artículo

Crea un objeto de metadatos de escritor rápido y devuelve un puntero de interfaz IVssCreateExpressWriterMetadata a él.

Sintaxis

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

Identificador único global (GUID) de la clase writer.

[in] writerName

Cadena de caracteres anchos terminada en NULL que contiene el nombre de la clase writer. Esta cadena no está localizada.

[in] usageType

Valor de enumeración VSS_USAGE_TYPE que indica cómo se usan los datos administrados por el escritor en el sistema host. Los únicos valores válidos para este parámetro son VSS_UT_BOOTABLESYSTEMSTATE, VSS_UT_SYSTEMSERVICE y VSS_UT_USERDATA.

[in] versionMajor

La versión principal de la aplicación de escritura. Para obtener más información, vea la sección Comentarios.

[in] versionMinor

La versión secundaria de la aplicación de escritura. Para obtener más información, vea la sección Comentarios.

[in] reserved

Este parámetro está reservado para uso del sistema.

[out] ppMetadata

Puntero a una variable que recibe un puntero de interfaz IVssCreateExpressWriterMetadata a los metadatos del escritor rápido recién creado.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Los parámetros versionMajor y versionMajor se usan para especificar los números de versión principal y secundaria del escritor según las siguientes convenciones de VSS:

  • El número de versión secundaria de un escritor debe incrementarse en uno cada vez que una versión publicada del escritor contiene cambios menores que afectan a la interacción del escritor con los solicitantes. Por ejemplo, una corrección a una especificación de archivo en un QFE de escritor o Service Pack justificaría el incremento del número de versión secundaria. Sin embargo, un cambio entre las versiones beta o la versión candidata para lanzamiento de un escritor no justificaría el cambio del número de versión secundaria.
  • El número de versión principal de un escritor debe incrementarse en uno cada vez que una versión publicada del escritor contiene un cambio significativo. Por ejemplo, si los datos de los que se realiza una copia de seguridad con una nueva versión de un escritor no se pueden restaurar mediante la versión anterior del escritor, se debe incrementar el número de versión principal del nuevo escritor.
  • Cada vez que se incrementa el número de versión principal, el número de versión secundaria debe restablecerse a cero.
Si un escritor no especifica un número de versión, VSS asignará un número de versión predeterminado de 0.0.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vswriter.h

Consulte también

CreateVssExpressWriter

IVssExpressWriter