DWORD lgLcdConnect(ref lgLcdConnectContext ctx);
DWORD lgLcdConnect(ref lgLcdConnectContext ctx);
/// <summary>
/// Use lgLcdConnect() to establish a connection to the LCD monitor process. This
/// connection is required for any other function to find, open and communicate with LCDs.
/// </summary>
/// <remarks>
/// A connection needs to be established for an application to start using LCD
/// devices. lgLcdConnect() attempts to establish that connection. If the LCD
/// Monitor process is not running (either because it has not been started or not
/// installed (the user is using a different keyboard)), the connection attempt
/// will not succeed. In that case, your application should consider running without
/// any LCD support.
///
/// Since a string is part of the connection context, this function exists in an ANSI
/// and a UNICODE version. The header file picks the appropriate version depending on
/// whether the symbol UNICODE is present or not.
/// </remarks>
/// <param name="ctx">
/// Pointer to a structure which holds all the relevant information about the connection
/// which you wish to establish. Upon calling, all fields except the “connection” member
/// need to be filled in; on return from the function, the “connection” member will be set.
/// See lgLcdConnectContext for details.
/// </param>
/// <returns>
/// If the function succeeds, the return value is ERROR_SUCCESS.
/// If the function fails, the return value can be one of the following:
///
/// ERROR_SERVICE_NOT_ACTIVE
/// lgLcdInit() has not been called yet.
/// ERROR_INVALID_PARAMETER
/// Either ctx or ctx->appFriendlyName are NULL.
/// ERROR_FILE_NOT_FOUND
/// LCDMon is not running on the system.
/// ERROR_ALREADY_EXISTS
/// The same client is already connected.
/// RPC_X_WRONG_PIPE_VERSION
/// LCDMon does not understand the protocol.
/// Xxx
/// Other (system) error with appropriate error code.
/// </returns>
[DllImport("LgLcd.dll")] private static extern int lgLcdConnect(ref lgLcdConnectContext ctx);
/// <summary>
/// Use lgLcdConnect() to establish a connection to the LCD monitor process. This
/// connection is required for any other function to find, open and communicate with LCDs.
/// </summary>
/// <remarks>
/// A connection needs to be established for an application to start using LCD
/// devices. lgLcdConnect() attempts to establish that connection. If the LCD
/// Monitor process is not running (either because it has not been started or not
/// installed (the user is using a different keyboard)), the connection attempt
/// will not succeed. In that case, your application should consider running without
/// any LCD support.
///
/// Since a string is part of the connection context, this function exists in an ANSI
/// and a UNICODE version. The header file picks the appropriate version depending on
/// whether the symbol UNICODE is present or not.
/// </remarks>
/// <param name="ctx">
/// Pointer to a structure which holds all the relevant information about the connection
/// which you wish to establish. Upon calling, all fields except the “connection” member
/// need to be filled in; on return from the function, the “connection” member will be set.
/// See lgLcdConnectContext for details.
/// </param>
/// <returns>
/// If the function succeeds, the return value is ERROR_SUCCESS.
/// If the function fails, the return value can be one of the following:
///
/// ERROR_SERVICE_NOT_ACTIVE
/// lgLcdInit() has not been called yet.
/// ERROR_INVALID_PARAMETER
/// Either ctx or ctx->appFriendlyName are NULL.
/// ERROR_FILE_NOT_FOUND
/// LCDMon is not running on the system.
/// ERROR_ALREADY_EXISTS
/// The same client is already connected.
/// RPC_X_WRONG_PIPE_VERSION
/// LCDMon does not understand the protocol.
/// Xxx
/// Other (system) error with appropriate error code.
/// </returns>
[DllImport("LgLcd.dll")] private static extern int lgLcdConnect(ref lgLcdConnectContext ctx);
