Método IVssBackupComponents::D isableWriterInstances (vsbackup.h)

  • Artículo

El método DisableWriterInstances deshabilita una instancia o instancias de escritor especificadas.

Sintaxis

HRESULT DisableWriterInstances(
  [in] const VSS_ID *rgWriterInstanceId,
  [in] UINT         cInstanceId
);

Parámetros

[in] rgWriterInstanceId

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

[in] cInstanceId

Número de entradas de la matriz rgWriterInstanceId .

Valor devuelto

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

Valor Significado
S_OK
 La clase writer se ha habilitado correctamente.
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 tiene varias copias en ejecución del mismo escritor, todas tendrán el mismo identificador de clase de escritor, pero tendrán identificadores de instancia de escritor diferentes. Deshabilitar una instancia de un escritor no hace que las demás instancias del escritor se deshabiliten.

Si llama a DisableWriterInstances, debe hacerlo antes de llamar al método IVssBackupComponents::GatherWriterMetadata . Si llama primero a GatherWriterMetadata y, a continuación, llama a DisableWriterInstances, la llamada a DisableWriterInstances no tiene ningún efecto. Si primero necesita llamar a GatherWriterMetadata , para determinar qué instancias de escritor deshabilitar, 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::EnableWriterClasses

IVssBackupComponents::GatherWriterMetadata