IVssProviderCreateSnapshotSet::AbortSnapshots method (vsprov.h)
The AbortSnapshots method aborts prepared shadow copies in this provider. This includes all non-committed shadow copies and pre-committed ones.
Syntax
HRESULT AbortSnapshots(
[in] VSS_ID SnapshotSetId
);
Parameters
[in] SnapshotSetId
The VSS_ID that identifies the shadow copy set.
Return value
This method can return one of these values.
Return code/value | Description |
---|---|
|
The operation was successfully completed. |
|
Out of memory or other system resources. |
|
One of the parameter values is not valid. |
|
The SnapshotSetId parameter refers to an object that was not found. |
|
An unexpected provider error occurred. The provider must log a message in the application event log providing the user with information on how to resolve the problem. |
Remarks
VSS will only call AbortSnapshots after the requester has called IVssBackupComponents::DoSnapshotSet, even if the shadow copy fails or is aborted before this point. This means that a provider will not receive an AbortSnapshots call until after EndPrepareSnapshots has been called. If a shadow copy is aborted or fails before this point, the provider is not given any indication until a new shadow copy is started. For this reason, the provider must be prepared to handle an out-of-sequence IVssHardwareSnapshotProvider::BeginPrepareSnapshot call at any point. This out-of-sequence call represents the start of a new shadow copy creation sequence and will have a new shadow copy set ID.
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 |