Método GetVirtualHardDiskSettingData da classe Msvm_ImageManagementService
Recupera os dados de configuração associados a um arquivo de disco rígido virtual.
Sintaxe
uint32 GetVirtualHardDiskSettingData(
[in] string Path,
[out] string SettingData,
[out] CIM_ConcreteJob REF Job
);
Parâmetros
-
Caminho [in]
-
O caminho totalmente qualificado do arquivo de imagem de disco.
-
SettingData [out]
-
Se tiver êxito, receberá uma instância inserida da classe Msvm_VirtualHardDiskSettingData que contém os dados de configuração do disco rígido virtual.
-
Trabalho [out]
-
Se a operação for executada de forma assíncrona, esse método retornará 4096 e esse parâmetro conterá uma referência a um objeto derivado de CIM_ConcreteJob.
Valor retornado
Esse método retorna um dos valores a seguir.
-
Concluído sem erro (0)
-
Parâmetros de método verificados – Trabalho iniciado (4096)
-
Falha (32768)
-
Acesso negado (32769)
-
Sem suporte (32770)
-
O status é desconhecido (32771)
-
Tempo limite (32772)
-
Parâmetro inválido (32773)
-
O sistema está em uso (32774)
-
Estado inválido para esta operação (32775)
-
Tipo de dados incorreto (32776)
-
O sistema não está disponível (32777)
-
Sem memória (32778)
-
Arquivo não encontrado (32779)
Comentários
O acesso à classe Msvm_ImageManagementService pode ser restrito pela Filtragem UAC. Para obter mais informações, consulte Controle de Conta de Usuário e WMI.
Exemplos
O exemplo de C# a seguir mostra como chamar o método GetVirtualHardDiskState . Os utilitários referenciados podem ser encontrados em utilitários comuns para os exemplos de virtualização (V2).
public static void GetVirtualHardDiskSettingData(string vhdPath)
{
ManagementScope scope = new ManagementScope(@"root\virtualization\V2", null);
ManagementObject imageService = Utility.GetServiceObject(scope, "Msvm_ImageManagementService");
ManagementBaseObject inParams = imageService.GetMethodParameters("GetVirtualHardDiskSettingData");
inParams["Path"] = vhdPath;
ManagementBaseObject outParams = imageService.InvokeMethod("GetVirtualHardDiskSettingData", inParams, null);
if ((UInt32)outParams["ReturnValue"] == ReturnCode.Started)
{
if (Utility.JobCompleted(outParams, scope))
{
Console.WriteLine("GetVirtualHardDiskSettingData was successful.");
}
else
{
Console.WriteLine("GetVirtualHardDiskSettingData was not successful.");
}
}
else if ((UInt32)outParams["ReturnValue"] == ReturnCode.Completed)
{
string diskStateString = outParams["SettingData"].ToString();
Utility.PrintEmbeddedInstance(diskStateString);
}
outParams.Dispose();
inParams.Dispose();
imageService.Dispose();
}
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\Virtualization\V2 |
| MOF |
|
| DLL |
|