Método IVssProviderCreateSnapshotSet::CommitSnapshots (vsprov.h)
El método CommitSnapshots confirma rápidamente todos los LUN de este proveedor.
Sintaxis
HRESULT CommitSnapshots(
[in] VSS_ID SnapshotSetId
);
Parámetros
[in] SnapshotSetId
El VSS_ID que identifica el conjunto de instantáneas.
Valor devuelto
| Código o valor devuelto | Descripción |
|---|---|
|
La operación se completó correctamente. |
|
Memoria insuficiente u otros recursos del sistema. |
|
Uno de los valores de parámetro no es válido. |
|
El parámetro SnapshotSetId hace referencia a un objeto que no se encontró. |
|
Error inesperado del proveedor. El proveedor debe registrar los detalles de este error en el registro de eventos de la aplicación. |
Si se devuelve cualquier otro valor, VSS escribirá un evento en el registro de eventos y convertirá el error en VSS_E_UNEXPECTED_PROVIDER_ERROR.
Comentarios
Se llama a este método en el momento definido en el que se deben tomar las instantáneas. Para cada LUN preparado en este conjunto de instantáneas, el proveedor realizará el trabajo necesario para conservar el contenido de LUN a un momento dado. Aunque este método se está ejecutando, tanto las aplicaciones como el subsistema de E/S son en gran medida inactivos. El proveedor debe minimizar la cantidad de tiempo invertido en este método. Como regla general, este método debe tardar menos de un segundo en completarse. Se llama a este método durante la ventana Vaciado y suspensión, y la compatibilidad con kernel de VSS cancelará el vaciado y la suspensión si la versión no se recibe en un plazo de 10 segundos, lo que provocaría que VSS produzca un error en el proceso de creación de instantáneas. Si cada proveedor tarda más de un segundo o dos en completar esta llamada, hay una probabilidad alta de que se produzca un error en toda la creación de instantáneas.
Dado que el sistema de E/S está inactivo, el proveedor debe tener cuidado de no iniciar ninguna E/S, ya que podría interbloquear el sistema, por ejemplo, depurar o rastrear E/S por este método o cualquier llamada realizada desde este método. Los archivos asignados a memoria y la E/S de paginación no se inmovilizarán en este momento.
Tenga en cuenta que el sistema de E/S solo está inactivo mientras se ejecuta este método. Inmediatamente después de que se devuelva el método CommitSnapshots del último proveedor, el servicio VSS libera todas las escrituras pendientes en los LUN de origen. Si el proveedor realiza cualquier sincronización de los LUN de origen y de instantáneas, esta sincronización debe completarse antes de que el método CommitSnapshots del proveedor devuelva; no se puede realizar de forma asincrónica.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vsprov.h |