IVssProviderCreateSnapshotSet::PreCommitSnapshots method (vsprov.h)
The PreCommitSnapshots method ensures the provider is ready to quickly commit the prepared LUNs. This happens immediately before the flush-and-hold writes, but while applications are in a frozen state. During this call the provider should prepare all shadow copies in the shadow copy set indicated by SnapshotSetId for committing by the CommitSnapshots method call that will follow. While the provider is processing this method, the applications have been frozen, so the time spent in this method should be minimized.
Syntax
HRESULT PreCommitSnapshots(
[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. |
|
The SnapshotSetId parameter refers to an object that was not found. |
|
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.
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 |