Método CreateClone da classe MSFT_VirtualDisk
Cria um clone de um disco virtual, resultando em um novo disco virtual cujos dados são idênticos aos do disco virtual original.
Sintaxe
UInt32 CreateClone(
[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 clone de disco virtual.
Esse parâmetro é necessário e não pode ser NULL.
TargetStoragePoolName [in]
O pool de armazenamento que deve ser usado para conter o clone 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 tempo 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 WMI padrão, 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 for 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 que é 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
Êxito (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)
Não há espaço livre suficiente (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)
Não há suporte para essa operação 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)
Comentários
Esse método cria um novo disco virtual cujos dados são idênticos aos do disco virtual de origem.
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 |
| MOF | Storagewmi.mof |