IMsRdpClientNonScriptable::SendKeys (Windows Embedded CE 6.0)
1/6/2010
This method sends a series of keystrokes to the Remote Desktop ActiveX control. The keystrokes are in scan-code form, which is the keyboard data from the physical keys.
Syntax
HRESULT SendKeys(
LONG numKeys,
VARIANT_BOOL* pbArrayKeyUp,
LONG* plKeyData
);
Parameters
- numKeys
[in] The number of keystrokes to send. The maximum number that can be sent in one operation is 20. The method returns E_INVALIDARG if this parameter is greater than 20.
- pbArrayKeyUp
[in] An array whose size is equal to numKeys. An element is TRUE if the corresponding key is UP and FALSE if the corresponding key is DOWN.
plKeyData
[in] An array whose size is equal to numKeys. The array contains keystroke data and corresponds to the value of the lParam parameter of the WM_KEYDOWN message. The data specifies the repeat count, scan code, extended-key flag, context code, previous key-state flag, and transition-state flag. For a description of the bits in this array, see WM_KEYDOWN.The corresponding element in pbArrayKeyUp indicates whether the key is UP or DOWN.
Return Value
The following table shows the return values for this method.
| Value | Description |
|---|---|
S_OK |
Keystrokes were sent. |
E_INVALIDARG |
A number more than 20 keystrokes was specified. |
nonzero error code |
An error occurred. |
Remarks
The SendKeys method does not mix keystrokes made by the local user with keystrokes sent by the method. All keystrokes passed to the method are sent to the remote session in a single sequence.
Requirements
| Header | discodlg.h, mstsax.idl |
| Library | Mstsax.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |