IVssProviderCreateSnapshotSet::PreFinalCommitSnapshots method (vsprov.h)
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 |
---|---|
|
The operation was successfully completed. |
|
Out of memory or other system resources. |
|
One of the parameter values is not valid. |
|
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 |