Compartilhar via


Método IMsRdpClientNonScriptable::SendKeys

Envia uma série de pressionamentos de teclas para o controle. Os pressionamentos de tecla estão no formulário de código de verificação, que são os dados de teclado das teclas físicas reais.

Sintaxe

HRESULT SendKeys(
  [in] LONG         numKeys,
  [in] VARIANT_BOOL *pbArrayKeyUp,
  [in] LONG         *plKeyData
);

Parâmetros

numKeys [in]

O número de pressionamentos de tecla a serem enviados. O número máximo de chaves que podem ser enviadas em uma operação é 20. O método retornará E_INVALIDARG se esse parâmetro for maior que 20. Para obter mais informações, consulte a seção Comentários a seguir.

pbArrayKeyUp [in]

Uma matriz cujo tamanho é igual a numKeys. Um elemento será TRUE se a chave correspondente for UP e FALSE se a chave correspondente for DOWN.

plKeyData [in]

Uma matriz cujo tamanho é igual a numKeys. A matriz contém dados de pressionamento de tecla e corresponde ao valor do parâmetro lParam da mensagem WM_KEYDOWN . Os dados especificam a contagem de repetição, o código de verificação, o sinalizador de chave estendida, o código de contexto, o sinalizador de estado-chave anterior e o sinalizador de estado de transição. Para obter uma descrição dos bits nessa matriz, consulte WM_KEYDOWN.

O elemento correspondente em pbArrayKeyUp indica se a chave é UP ou DOWN.

Valor retornado

Retorne S_OK se tiver êxito.

Comentários

O método SendKeys não combina pressionamentos de teclas feitos pelo usuário local com pressionamentos de tecla que o método está enviando. Todos os pressionamentos de tecla passados para o método são enviados para a sessão remota em uma única sequência atômica.

Para obter mais informações sobre a Conexão da Web da Área de Trabalho Remota, consulte Requisitos para conexão da Web da Área de Trabalho Remota.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Biblioteca de tipos
MsTscAx.dll
DLL
MsTscAx.dll
IID
IID_IMsRdpClientNonScriptable é definido como 2f079c4c-87b2-4afd-97ab-20cdb43038ae

Confira também