Método IVssBackupComponents::EnableWriterClasses (vsbackup.h)

  • Artículo

El método EnableWriterClasses permite a los escritores especificados recibir todos los eventos.

Sintaxis

HRESULT EnableWriterClasses(
  [in] const VSS_ID *rgWriterClassId,
  [in] UINT         cClassId
);

Parámetros

[in] rgWriterClassId

Matriz que contiene uno o varios identificadores de clase de escritor.

[in] cClassId

Número de entradas de la matriz rgWriterClassId .

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Valor Significado
S_OK
 Habilitó correctamente la clase writer.
E_ACCESSDENIED
 El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es un administrador.
E_OUTOFMEMORY
 El autor de la llamada no tiene memoria u otros recursos del sistema.
VSS_E_BAD_STATE
 El objeto de componentes de copia de seguridad no se inicializa, se ha llamado a este método durante una operación de restauración o no se ha llamado a este método dentro de la secuencia correcta.
VSS_E_UNEXPECTED
 error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, vea Control de eventos y errores en VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Server 2008 R2 y Windows 7. E_UNEXPECTED se usa en su lugar.

Comentarios

Si nunca se llama al método EnableWriterClasses y al método IVssBackupComponents::D isableWriterClasses , se habilitan todas las clases de escritor.

Después de que se devuelva la primera llamada a EnableWriterClasses , las clases de escritor especificadas en la matriz rgWriterClassId están habilitadas y todas las demás clases de escritor están deshabilitadas.

Si llama a EnableWriterClasses más de una vez, cada llamada agrega los escritores de la matriz rgWriterClassId a la lista de escritores habilitados.

Si llama a EnableWriterClasses una o varias veces y, a continuación, llama a DisableWriterClasses, la llamada a DisableWriterClasses deshabilita los escritores de la matriz rgWriterClassId que se habilitaron en las llamadas a EnableWriterClasses.

Si llama a EnableWriterClasses, debe hacerlo antes de llamar al método IVssBackupComponents::GatherWriterMetadata . Si llama primero a GatherWriterMetadata y, a continuación, llama a EnableWriterClasses, la llamada a EnableWriterClasses no tiene ningún efecto. Si primero necesita llamar a GatherWriterMetadata para determinar qué clases de escritor habilitar, debe llamarla desde otra instancia de la interfaz IVssBackupComponents .

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h)
Library VssApi.lib

Consulte también

IVssBackupComponents

IVssBackupComponents::D isableWriterClasses

IVssBackupComponents::D isableWriterInstances