Compartilhar via


Método IVMMouse::GetButton

[O Computador Virtual do Windows não está mais disponível para uso a partir de Windows 8. Em vez disso, use o provedor WMI do Hyper-V (V2).]

Recupera o estado atual (para cima ou para baixo) do botão do mouse especificado.

Sintaxe

HRESULT GetButton(
  [in]          VMMouseButton buttonIndex,
  [out, retval] VARIANT_BOOL  *isDown
);

Parâmetros

buttonIndex [in]

O índice do botão cujo estado está sendo solicitado. Para obter uma lista de valores, consulte VMMouseButton.

isDown [out, retval]

O estado do botão indicado. TRUE se o botão estiver inativo na máquina virtual, caso contrário, FALSE .

Valor retornado

Esse método pode retornar um desses valores.

Retornar código/valor Descrição
S_OK
0
A operação foi bem-sucedida.
E_POINTER
0x80004003
O parâmetro isDown é NULL.
E_INVALIDARG
0x80000003
O parâmetro buttonIndex não é válido.
VM_E_VM_NOT_RUNNING
0xA0040206
A máquina virtual à qual este dispositivo do mouse está anexado não está em execução no momento.
VM_E_MOUSE_NOT_ACTIVE
0xA0040800
O dispositivo do mouse não foi ligado.
DISP_E_EXCEPTION
0x80020009
Ocorreu um erro inesperado.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Nenhum compatível
Fim do suporte ao cliente
Windows 7
Produto
Windows Virtual PC
Cabeçalho
VPCCOMInterfaces.h
IID
IID_IVMmouse é definido como ac903f6d-6346-4f29-8875-5d511a13895e

Confira também

IVMMouse