Método CreateSnapshot da classe MSFT_VirtualDisk
Cria um novo disco virtual que é uma cópia de sombra do disco virtual existente.
Sintaxe
UInt32 CreateSnapshot(
[in] String FriendlyName,
[in] String TargetStoragePoolName,
[in] Boolean RunAsJob,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String CreatedVirtualDisk,
[out] String ExtendedStatus
);
Parâmetros
FriendlyName [in]
O nome desejado do disco virtual de cópia de sombra.
Esse parâmetro é necessário e não pode ser NULL.
TargetStoragePoolName [in]
O pool de armazenamento que deve ser usado para armazenar o instantâneo criado. Se esse parâmetro não estiver definido, esse método usará o mesmo pool de armazenamento que contém o disco virtual de origem.
RunAsJob [in]
Se TRUE, esse método usará o parâmetro CreatedStorageJob quando a solicitação estiver demorando muito para ser atendida. Se um trabalho de armazenamento tiver sido criado para acompanhar a operação, esse método retornará Parâmetros de Método Verificados – Trabalho Iniciado.
Observação
Mesmo que RunAsJob seja TRUE, esse método ainda poderá retornar um resultado se tiver terminado em tempo suficiente.
Se FALSE ou NULL, esse método seguirá o comportamento assíncrono padrão do WMI, conforme determinado pelo método do cliente para invocação. Em outras palavras, ele é síncrono, a menos que solicitado de outra forma.
CreatedStorageJob [out]
Se RunAsJob estiver definido como TRUE e esse método levar muito tempo para ser executado, esse parâmetro receberá uma referência ao objeto de trabalho de armazenamento usado para acompanhar a operação de execução prolongada.
CreatedVirtualDisk [out]
Se o disco virtual for criado com êxito, esse parâmetro receberá uma cadeia de caracteres que contém um objeto MSFT_VirtualDisk inserido.
ExtendedStatus [out]
Uma cadeia de caracteres que contém um objeto MSFT_StorageExtendedStatus inserido.
Esse parâmetro permite que o provedor de armazenamento retorne informações de erro estendidas (específicas da implementação).
Retornar valor
Sucesso (0)
Sem suporte (1)
Erro não especificado (2)
Tempo limite (3)
Falha (4)
Parâmetro inválido (5)
Parâmetros de método verificados – Trabalho iniciado (4096)
Espaço livre insuficiente (40000)
Acesso negado (40001)
Não há recursos suficientes para concluir a operação. (40002)
Cache desatualizado (40003)
Não é possível se conectar ao provedor de armazenamento. (46000)
O provedor de armazenamento não pode se conectar ao subsistema de armazenamento. (46001)
Essa operação não tem suporte em pools de armazenamento primordiais. (48000)
O pool de armazenamento é reservado apenas para uso especial. (48001)
Não foi possível encontrar o pool de armazenamento especificado. (48005)
O pool de armazenamento não pôde concluir a operação porque sua integridade ou status operacional não a permite. (48006)
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Namespace | Root\Microsoft\Windows\Storage |
| parâmetro | Dbdaoint.h |
| MOF | Storagewmi.mof |