Método IVssBackupComponents::D isableWriterClasses (vsbackup.h)
El método DisableWriterClasses impide que una clase específica de escritores reciba eventos.
Sintaxis
HRESULT DisableWriterClasses(
[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.
| Value | Significado |
|---|---|
|
La clase writer se ha deshabilitado correctamente. |
|
El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es administrador. |
|
El autor de la llamada no tiene memoria u otros recursos del sistema. |
|
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. |
|
error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, consulte 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 clase de escritor hace que todas las instancias del escritor se deshabiliten.
Si nunca se llama al método DisableWriterClasses y al método IVssBackupComponents::EnableWriterClasses , se habilitan todas las clases de escritor.
Una vez que se devuelve la primera llamada a DisableWriterClasses , las clases de escritor especificadas en la matriz rgWriterClassId están deshabilitadas y todas las demás clases de escritor están habilitadas.
Si llama a DisableWriterClasses más de una vez, cada llamada agrega los escritores en la matriz rgWriterClassId a la lista de escritores deshabilitados.
Si llama a DisableWriterClasses una o varias veces y, a continuación, llama a EnableWriterClasses, la primera llamada a EnableWriterClasses cancela el efecto de las llamadas a DisableWriterClasses y habilita solo los escritores de la matriz rgWriterClassId .
Si llama a DisableWriterClasses, debe hacerlo antes de llamar al método IVssBackupComponents::GatherWriterMetadata . Si llama primero a GatherWriterMetadata y, a continuación, llama a DisableWriterClasses, la llamada a DisableWriterClasses no tiene ningún efecto. Si primero necesita llamar a GatherWriterMetadata para determinar qué clases de escritor deshabilitar, debe llamarla desde otra instancia de la interfaz IVssBackupComponents .
Requisitos
| 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 |