CreateSnapshot method of the MSFT_SMStorageVolume class
Starts a job to create an associated un-synced snapshot of the MSFT_SMStorageVolume.
Syntax
uint32 CreateSnapshot(
[in, optional] string ElementName,
[out, optional] MSFT_SMStorageVolume REF TargetStorageVolume,
[in, optional] MSFT_SMPool REF TargetPool,
[in, optional] String username,
[in, optional] String password,
[out] MSFT_SMJob REF Job,
[out, optional] MSFT_SMExtendedStatus ExtendedStatus
);
Parameters
-
ElementName [in, optional]
-
End-user relevant name for the element being created. If NULL, then a system supplied name is used.
-
TargetStorageVolume [out, optional]
-
A reference to the created target storage element, that is the replica. If a job is created, the target element may not be available immediately.
-
TargetPool [in, optional]
-
The underlying storage for the target element (the replica) will be drawn from TargetPool if specified, otherwise the allocation is implementation specific.
-
username [in, optional]
-
Used to authenticate with the SMI-S provider. If not provided, the storage service attempts to obtain these credentials from the configuration provider.
-
password [in, optional]
-
Used to authenticate with the SMI-S provider. If not provided, the storage service attempts to obtain these credentials from the configuration provider.
-
Job [out]
-
Reference to the MSFT_SMJob instance. May be NULL if the job is completed.
-
ExtendedStatus [out, optional]
-
An MSFT_SMExtendedStatus object containing the results of calling this method.
Return value
-
Success
-
0
-
Not Supported
-
1
-
Unspecified Error
-
2
-
Timeout
-
3
-
Failed
-
4
-
Invalid Parameter
-
5
-
Method Parameters Checked - Job Started
-
4096
-
StorageService: Method invocation failed
-
40300
-
StorageService: Cannot modify volume instance
-
40304
-
StorageService: Snapshot capability not supported
-
40308
-
StorageService: Replication type not supported per reported capabilities
-
40500
-
StorageService CIM Error: Failed
-
43001
-
StorageService CIM Error: Access denied
-
43002
-
StorageService CIM Error: Invalid namespace
-
43003
-
StorageService CIM Error: Invalid parameter
-
43004
-
StorageService CIM Error: Invalid class
-
43005
-
StorageService CIM Error: Not found
-
43006
-
StorageService CIM Error: Not supported
-
43007
-
StorageService CIM Error: Class has children
-
43008
-
StorageService CIM Error: Class has instances
-
43009
-
StorageService CIM Error: Invalid superclass
-
43010
-
StorageService CIM Error: Already exists
-
43011
-
StorageService CIM Error: No such propert
-
43012
-
StorageService CIM Error: Type mismatch
-
43013
-
StorageService CIM Error: Query language not supported
-
43014
-
StorageService CIM Error: Invalid query
-
43015
-
StorageService CIM Error: Method not available
-
43016
-
StorageService CIM Error: Method not found
-
43017
-
StorageService CIM Error: Unexpected response
-
43018
-
StorageService CIM Error: Invalid response destination
-
43019
-
StorageService CIM Error: Namespace not empty
-
43020
-
StorageService CIM Error: No such property
-
43012
-
StorageService CIM Error: Invalid enumeration context
-
43021
Windows Server 2012 R2: Unavailable for Windows Server 2012.
-
StorageService CIM Error: Invalid operation timeout
-
43022
-
StorageService CIM Error: Pull has been abandoned
-
43023
-
StorageService CIM Error: Pull cannot be abandoned
-
43024
-
StorageService CIM Error: Filtered enumeration not supported
-
43025
-
StorageService CIM Error: Continuation on error not supported
-
43026
-
StorageService CIM Error: Server limits exceeded
-
43027
-
StorageService CIM Error: Server is shutting down
-
43028
-
StorageService CIM Error: Query feature not supported
-
43029
-
StorageService: Generic Failure
-
51000
-
StorageService: Invalid connection credentials
-
51005
-
StorageService: SSL connection failure
-
51010
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2012 |
| Namespace |
Root\Microsoft\Windows\Storage\SM |
| Header |
|
| MOF |
|
| DLL |
|