Partilhar via


Método EnableDevice da classe CIM_LogicalDevice (Hyper-V)

O método EnableDevice foi obsoleto em favor do método mais geral RequestStateChange, que se sobrepõe diretamente à funcionalidade fornecida por este método.

Solicita que o LogicalDevice seja ativado (parâmetro de entrada "Enabled" = TRUE) ou desativado (= FALSE). Se for bem-sucedido, as propriedades StatusInfo/EnabledState do Dispositivo devem refletir o estado desejado (ativado/desativado). Note que a função deste método sobrepõe-se à propriedade RequestedState. RequestedState foi adicionado ao modelo para manter um registo (ou seja, um valor persistente) do último pedido de estado. Invocar o método EnableDevice deve definir a propriedade RequestedState de forma adequada.

O código de retorno deve ser 0 se o pedido foi executado com sucesso, 1 se o pedido não for suportado e algum outro valor se ocorrer um erro. Numa subclasse, o conjunto de possíveis códigos de retorno podia ser especificado, usando um qualificador ValueMap no método. As strings para as quais o conteúdo do ValueMap é 'traduzido' também podem ser especificadas na subclasse como um qualificador de um array Values.

Sintaxe

uint32 EnableDevice(
  [in] boolean Enabled
);

Parâmetros

Ativado [em]

Se TRUE ativa o dispositivo, se FALSE desativa o dispositivo.

Valor de retorno

Devolve 0 no sucesso; caso contrário, devolve um erro.

Requisitos

Requisito Valor
Cliente mínimo suportado
Windows 8.1
Servidor mínimo suportado
Windows Server 2012 R2
Namespace
Raiz\virtualização\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Consulte também

CIM_LogicalDevice