IVssProviderCreateSnapshotSet::PostFinalCommitSnapshots method

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

SnapshotSetId [in]

The VSS_ID that identifies the shadow copy set.

Return value

Return code/valueDescription
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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008, Windows Server 2003 with SP1 [desktop apps only]

Header

VsProv.h

See also

IVssProviderCreateSnapshotSet

 

 

Show: