Edit

IVssProviderCreateSnapshotSet::PreFinalCommitSnapshots method (vsprov.h)

  • Article

The PreFinalCommitSnapshots method enables providers to support auto-recover shadow copies. If the shadow copy has the VSS_VOLSNAP_ATTR_AUTORECOVER flag set in the context, the volume can receive a large number of writes during the auto-recovery operation.

Syntax

HRESULT PreFinalCommitSnapshots(
  [in] VSS_ID SnapshotSetId
);

Parameters

[in] SnapshotSetId

The VSS_ID that identifies the shadow copy set.

Return value

Return code/value Description
S_OK
0x00000000L
 The operation was successfully completed.
E_OUTOFMEMORY
0x8007000EL
 Out of memory or other system resources.
E_INVALIDARG
0x80070057L
 One of the parameter values is not valid.
VSS_E_PROVIDER_VETO
0x80042306L
 An unexpected provider error occurred. If this is returned, the error must be described in an entry in the application event log, giving the user information on how to resolve the problem.
 

If any other value is returned, VSS will write an event to the event log and convert the error to VSS_E_UNEXPECTED_PROVIDER_ERROR.

Remarks

This method was added to enable binary compatibility when the auto-recover feature was introduced in Windows Server 2003 with Service Pack 1 (SP1).

Note  For Windows Server 2003, it is recommended that hardware providers implement this method using the following example:
 
HRESULT PreFinalCommitSnapshots(
VSS_ID     /* SnapshotSetId */
)
{
    return S_OK;
}

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header vsprov.h

See also

IVssProviderCreateSnapshotSet