Clase CVssWriter (vswriter.h)
La clase CVssWriter es una clase base abstracta que define la interfaz por la que un escritor sincroniza su estado con VSS y otros escritores.
Cada escritor debe crear una instancia de un objeto derivado de CVssWriter.
Los objetos derivados de CVssWriter deben proporcionar implementaciones para todos los métodos virtuales puros de CVssWriter.
Un escritor puede invalidar uno o todos los métodos virtuales de CVssWriter.
Para participar en VSS, un escritor primero debe llamar a CVssWriter::Initialize y, a continuación, llamar a CVssWriter::Subscribe.
Un escritor finaliza su participación llamando a CVssWriter::Unsubscribe.
La clase base CVssWriter es responsable del ciclo de vida de las interfaces que se pasan a los controladores de eventos. Entre estas estructuras se incluyen las siguientes:
- Instancia de la interfaz IVssWriterComponents pasada a: CVssWriter::OnPrepareBackup
- Instancia de la interfaz IVssCreateWriterMetadata pasada a CVssWriter::OnIdentify.
Métodos
La clase CVssWriter tiene estos métodos.
| CVssWriter::~CVssWriter ~CVssWriter es el destructor del objeto de clase CVssWriter. |
| CVssWriter::AreComponentsSelected El método AreComponentsSelected indica si un solicitante se ejecuta en modo de componente y admite la selección de componentes individuales de los que se va a realizar una copia de seguridad o realiza una copia de seguridad de volúmenes completos. |
| CVssWriter::CVssWriter CVssWriter es el constructor del objeto de clase CVssWriter. |
| CVssWriter::GetBackupType El método GetBackupType indica el tipo de copia de seguridad que se va a realizar. |
| CVssWriter::GetContext La información de GetContext devuelve el contexto actual de las instantáneas en curso o posibles. |
| CVssWriter::GetCurrentLevel El método GetCurrentLevel devuelve el nivel de aplicación actual. |
| CVssWriter::GetCurrentSnapshotSetId El método GetCurrentSnapshotSetId devuelve el identificador único del conjunto de instantáneas. |
| CVssWriter::GetCurrentVolumeArray El método GetCurrentVolumeArray devuelve los nombres de los volúmenes originales y las rutas de acceso UNC de los recursos compartidos de archivos remotos originales que pertenecen al conjunto de instantáneas como una matriz de cadenas de caracteres anchos terminadas en NULL. Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP y Windows Server 2003: los recursos compartidos de archivos remotos no se admiten hasta Windows 8 y Windows Server 2012. |
| CVssWriter::GetCurrentVolumeCount El método GetCurrentVolumeCount devuelve el número de volúmenes del conjunto de instantáneas. |
| CVssWriter::GetRestoreType El método GetRestoreType devuelve el tipo de restauración en el que participa un escritor. |
| CVssWriter::GetSnapshotDeviceName El método GetSnapshotDeviceName devuelve el nombre del dispositivo que hospeda la instantánea del volumen o recurso compartido de archivos especificado. |
| CVssWriter::Initialize Inicializa un objeto CVssWriter y permite que una aplicación de escritor interactúe con VSS. |
| CVssWriter::InstallAlternateWriter No compatible. (CVssWriter.InstallAlternateWriter) |
| CVssWriter::IsBootableSystemStateBackedUp El método IsBootableSystemStateBackedUp indica si se realizará una copia de seguridad del estado de arranque. |
| CVssWriter::IsPartialFileSupportEnabled El método IsPartialFileSupportEnabled determina si la compatibilidad parcial con archivos está habilitada o deshabilitada. |
| CVssWriter::IsPathAffected El método IsPathAffected determina si el directorio o el archivo especificados se incluyen en el conjunto de instantáneas actual. La ruta de acceso del directorio o archivo puede ser una ruta de acceso local o una ruta unc de un recurso compartido de archivos remoto. |
| CVssWriter::OnAbort Un escritor llama al método OnAbort después de un evento Abort emitido por VSS que indica que una operación de instantánea ha finalizado prematuramente. El escritor usa este método para limpiar de su intento de participar en esa operación. |
| CVssWriter::OnBackOffIOOnVolume No compatible. (CVssWriter.OnBackOffIOOnVolume) |
| CVssWriter::OnBackupComplete Un escritor llama al método OnBackupComplete después de un evento BackupComplete. Se usa para realizar operaciones que se consideran necesarias después de una copia de seguridad. Sin embargo, estas operaciones no pueden modificar el documento componentes de copia de seguridad. |
| CVssWriter::OnBackupShutdown Un escritor llama al método OnBackupShutdown después de un evento BackupShutdown. Se usa para realizar operaciones que se consideran necesarias cuando se cierra una aplicación de copia de seguridad, especialmente en el caso de un bloqueo de la aplicación de copia de seguridad. |
| CVssWriter::OnContinueIOOnVolume No compatible. (CVssWriter.OnContinueIOOnVolume) |
| CVssWriter::OnFreeze Un escritor llama al método OnFreeze al recibir un evento Freeze al principio de una inmovilización de instantáneas. Un escritor usa este método para realizar operaciones necesarias para participar en la inmovilización o para vetar la inmovilización. |
| CVssWriter::OnIdentify Un escritor llama al método OnIdentify después de recibir un evento Identify. |
| CVssWriter::OnPostRestore Un escritor llama al método OnPostRestore después de un evento PostRestore. Se usa para realizar operaciones que se consideran necesarias después de que un solicitante restaure los archivos en el disco. Sin embargo, estas operaciones no pueden modificar el documento componentes de copia de seguridad. |
| CVssWriter::OnPostSnapshot Un escritor llama al método OnPostSnapshot después de un evento PostSnapshot. |
| CVssWriter::OnPrepareBackup Un escritor llama al método OnPrepareBackup después de un evento PrepareForBackup. Este método se usa para configurar el estado de un escritor y sus componentes como preparación para una operación de copia de seguridad. |
| CVssWriter::OnPrepareSnapshot Un escritor llama al método OnPrepareSnapshot para controlar un evento PrepareForSnapshot. Se usa para realizar operaciones necesarias para preparar un escritor para participar en la instantánea o para vetar una instantánea. |
| CVssWriter::OnPreRestore Un escritor llama al método OnPreRestore después de un evento PreRestore. |
| CVssWriter::OnThaw Un escritor llama al método OnThaw después de un evento Thaw. |
| CVssWriter::OnVSSApplicationStartup No compatible. (CVssWriter.OnVSSApplicationStartup) |
| CVssWriter::OnVSSShutdown No compatible. (CVssWriter.OnVssShutdown) |
| CVssWriter::SetWriterFailure El método SetWriterFailure indica que este escritor ha encontrado una condición de error y establece una condición de error. |
| CVssWriter::Subscribe El método Subscribe suscribe el escritor con VSS. |
| CVssWriter::Unsubscribe El método Unsubscribe cancela la suscripción al escritor con VSS. |
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 | vswriter.h (incluya Vss.h, VsWriter.h) |