Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |