IVssProviderCreateSnapshotSet::PostFinalCommitSnapshots method (vsprov.h)

  • Article

The PostFinalCommitSnapshots method supports auto-recover shadow copies. VSS calls this method to notify the provider that the volume will now be read-only until a requester calls IVssBackupComponents::BreakSnapshotSet.

Syntax

HRESULT PostFinalCommitSnapshots(
  [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 in Windows Server 2003 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 PostFinalCommitSnapshots(
    VSS_ID     /* SnapshotSetId */
)
{
    return S_OK;
}

Requirements

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

See also

IVssProviderCreateSnapshotSet