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

See also

MSFT_SMStorageVolume