24#include <winpr/assert.h>
25#include <winpr/cast.h>
27#include <freerdp/config.h>
29#include <freerdp/freerdp.h>
30#include <freerdp/gdi/gdi.h>
31#include <freerdp/client/cmdline.h>
33#include <freerdp/server/proxy/proxy_log.h>
34#include <freerdp/channels/drdynvc.h>
35#include <freerdp/channels/encomsp.h>
36#include <freerdp/channels/rdpdr.h>
37#include <freerdp/channels/rdpsnd.h>
38#include <freerdp/channels/cliprdr.h>
39#include <freerdp/channels/channels.h>
42#include "pf_channel.h"
43#include <freerdp/server/proxy/proxy_context.h>
46#include <freerdp/server/proxy/proxy_config.h>
47#include "proxy_modules.h"
49#include "channels/pf_channel_rdpdr.h"
50#include "channels/pf_channel_smartcard.h"
52#define TAG PROXY_TAG("client")
54static void channel_data_free(
void* obj);
57static BOOL proxy_server_reactivate(rdpContext* ps,
const rdpContext* pc)
62 if (!pf_context_copy_settings(ps->settings, pc->settings))
69 WINPR_ASSERT(ps->update);
70 return (ps->update->DesktopResize(ps));
73static void pf_client_on_error_info(
void* ctx,
const ErrorInfoEventArgs* e)
75 pClientContext* pc = (pClientContext*)ctx;
76 pServerContext* ps =
nullptr;
79 WINPR_ASSERT(pc->pdata);
84 if (e->code == ERRINFO_NONE)
87 PROXY_LOG_WARN(TAG, pc,
"received ErrorInfo PDU. code=0x%08" PRIu32
", message: %s", e->code,
88 freerdp_get_error_info_string(e->code));
91 freerdp_set_error_info(ps->context.rdp, e->code);
92 if (!freerdp_send_error_info(ps->context.rdp))
94 PROXY_LOG_WARN(TAG, pc,
"[fail] reply ErrorInfo PDU. code=0x%08" PRIu32
", message: %s",
95 e->code, freerdp_get_error_info_string(e->code));
99static void pf_client_on_activated(WINPR_ATTR_UNUSED
void* ctx,
100 WINPR_ATTR_UNUSED
const ActivatedEventArgs* e)
105static BOOL pf_client_load_rdpsnd(pClientContext* pc)
107 rdpContext* context = (rdpContext*)pc;
110 WINPR_ASSERT(pc->pdata);
115 if (!freerdp_static_channel_collection_find(context->settings, RDPSND_CHANNEL_NAME))
117 const char* params[2] = { RDPSND_CHANNEL_NAME,
"sys:fake" };
119 if (!freerdp_client_add_static_channel(context->settings, ARRAYSIZE(params), params))
127static BOOL pf_client_use_peer_load_balance_info(pClientContext* pc)
129 pServerContext* ps =
nullptr;
130 rdpSettings* settings =
nullptr;
131 DWORD lb_info_len = 0;
132 const char* lb_info =
nullptr;
135 WINPR_ASSERT(pc->pdata);
138 settings = pc->context.settings;
139 WINPR_ASSERT(settings);
141 lb_info = freerdp_nego_get_routing_token(&ps->context, &lb_info_len);
150static BOOL str_is_empty(
const char* str)
154 if (strlen(str) == 0)
160static BOOL pf_client_use_proxy_smartcard_auth(
const rdpSettings* settings)
169 if (str_is_empty(key))
172 if (str_is_empty(cert))
179static BOOL pf_client_pre_connect(freerdp* instance)
181 pClientContext* pc =
nullptr;
182 pServerContext* ps =
nullptr;
183 const proxyConfig* config =
nullptr;
184 rdpSettings* settings =
nullptr;
186 WINPR_ASSERT(instance);
187 pc = (pClientContext*)instance->context;
189 WINPR_ASSERT(pc->pdata);
192 WINPR_ASSERT(ps->pdata);
193 config = ps->pdata->config;
194 WINPR_ASSERT(config);
195 settings = instance->context->settings;
196 WINPR_ASSERT(settings);
209 ZeroMemory(OrderSupport, 32);
211 if (WTSVirtualChannelManagerIsChannelJoined(ps->vcm, DRDYNVC_SVC_CHANNEL_NAME))
225 config->DeviceRedirection) ||
229 if (config->RemoteApp)
231 if (WTSVirtualChannelManagerIsChannelJoined(ps->vcm, RAIL_SVC_CHANNEL_NAME))
238 if (config->DeviceRedirection)
240 if (WTSVirtualChannelManagerIsChannelJoined(ps->vcm, RDPDR_SVC_CHANNEL_NAME))
251 config->DisplayControl))
254 if (WTSVirtualChannelManagerIsChannelJoined(ps->vcm, ENCOMSP_SVC_CHANNEL_NAME))
260 if (config->Clipboard)
262 if (WTSVirtualChannelManagerIsChannelJoined(ps->vcm, CLIPRDR_SVC_CHANNEL_NAME))
272 if (PubSub_SubscribeErrorInfo(instance->context->pubSub, pf_client_on_error_info) < 0)
274 if (PubSub_SubscribeActivated(instance->context->pubSub, pf_client_on_activated) < 0)
276 if (!pf_client_use_peer_load_balance_info(pc))
279 return pf_modules_run_hook(pc->pdata->module, HOOK_TYPE_CLIENT_PRE_CONNECT, pc->pdata, pc);
291static BOOL updateBackIdFn(WINPR_ATTR_UNUSED
const void* key,
void* value,
void* arg)
293 pServerStaticChannelContext* current = (pServerStaticChannelContext*)value;
294 UpdateBackIdArgs* updateArgs = (UpdateBackIdArgs*)arg;
296 if (strcmp(updateArgs->name, current->channel_name) != 0)
299 current->back_channel_id = updateArgs->backId;
300 if (!HashTable_Insert(updateArgs->ps->channelsByBackId, ¤t->back_channel_id, current))
302 WLog_ERR(TAG,
"error inserting channel in channelsByBackId table");
308static BOOL pf_client_update_back_id(pServerContext* ps,
const char* name, UINT32 backId)
310 UpdateBackIdArgs res = { ps, name, backId };
312 return HashTable_Foreach(ps->channelsByFrontId, updateBackIdFn, &res) == FALSE;
316static BOOL pf_client_load_channels(freerdp* instance)
318 pClientContext* pc =
nullptr;
319 pServerContext* ps =
nullptr;
320 const proxyConfig* config =
nullptr;
321 rdpSettings* settings =
nullptr;
323 WINPR_ASSERT(instance);
324 pc = (pClientContext*)instance->context;
326 WINPR_ASSERT(pc->pdata);
329 WINPR_ASSERT(ps->pdata);
330 config = ps->pdata->config;
331 WINPR_ASSERT(config);
332 settings = instance->context->settings;
333 WINPR_ASSERT(settings);
338 PROXY_LOG_INFO(TAG, pc,
"Loading addins");
340 if (!pf_client_load_rdpsnd(pc))
342 PROXY_LOG_ERR(TAG, pc,
"Failed to load rdpsnd client");
346 if (!pf_utils_is_passthrough(config))
348 if (!freerdp_client_load_addins(instance->context->channels, settings))
350 PROXY_LOG_ERR(TAG, pc,
"Failed to load addins");
356 if (!pf_channel_rdpdr_client_new(pc))
358#if defined(WITH_PROXY_EMULATE_SMARTCARD)
359 if (!pf_channel_smartcard_client_new(pc))
363 if (!freerdp_channels_from_mcs(settings, &ps->context))
369 settings, FreeRDP_ChannelDefArray, 0);
371 UINT32
id = MCS_GLOBAL_CHANNEL_ID + 1;
373 WINPR_ASSERT(channels || (size == 0));
381 dev.channel_name = cur->name;
382 dev.flags = cur->options;
385 if (!pf_modules_run_filter(pc->pdata->module,
386 FILTER_TYPE_CLIENT_PASSTHROUGH_CHANNEL_CREATE, pc->pdata,
389 const size_t s = size - MIN(size, x + 1);
395 if (!pf_client_update_back_id(ps, cur->name,
id++))
397 WLog_ERR(TAG,
"unable to update backid for channel %s", cur->name);
408 return pf_modules_run_hook(pc->pdata->module, HOOK_TYPE_CLIENT_LOAD_CHANNELS, pc->pdata, pc);
412static BOOL pf_client_receive_channel_data_hook(freerdp* instance, UINT16 channelId,
413 const BYTE* xdata,
size_t xsize, UINT32 flags,
416 pClientContext* pc =
nullptr;
417 pServerContext* ps =
nullptr;
418 proxyData* pdata =
nullptr;
419 pServerStaticChannelContext* channel =
nullptr;
420 UINT64 channelId64 = channelId;
422 WINPR_ASSERT(instance);
423 WINPR_ASSERT(xdata || (xsize == 0));
425 pc = (pClientContext*)instance->context;
427 WINPR_ASSERT(pc->pdata);
435 channel = HashTable_GetItemValue(ps->channelsByBackId, &channelId64);
439 WINPR_ASSERT(channel->onBackData);
440 switch (channel->onBackData(pdata, channel, xdata, xsize, flags, totalSize))
442 case PF_CHANNEL_RESULT_PASS:
446 if (channel->front_channel_id == 0)
449 return ps->context.peer->SendChannelPacket(
450 ps->context.peer, WINPR_ASSERTING_INT_CAST(UINT16, channel->front_channel_id),
451 totalSize, flags, xdata, xsize);
452 case PF_CHANNEL_RESULT_DROP:
454 case PF_CHANNEL_RESULT_ERROR:
461static BOOL pf_client_on_server_heartbeat(freerdp* instance, BYTE period, BYTE count1, BYTE count2)
463 pClientContext* pc =
nullptr;
464 pServerContext* ps =
nullptr;
466 WINPR_ASSERT(instance);
467 pc = (pClientContext*)instance->context;
469 WINPR_ASSERT(pc->pdata);
473 return freerdp_heartbeat_send_heartbeat_pdu(ps->context.peer, period, count1, count2);
482 return Queue_Enqueue(pc->cached_server_channel_data, ev);
486static BOOL sendQueuedChannelData(pClientContext* pc)
496 Queue_Lock(pc->cached_server_channel_data);
497 while (rc && (ev = Queue_Dequeue(pc->cached_server_channel_data)))
499 UINT16 channelId = 0;
500 WINPR_ASSERT(pc->context.instance);
502 channelId = freerdp_channels_get_id_by_name(pc->context.instance, ev->channel_name);
504 if ((channelId == 0) || (channelId == UINT16_MAX))
508 WINPR_ASSERT(pc->context.instance->SendChannelPacket);
509 rc = pc->context.instance->SendChannelPacket(pc->context.instance, channelId,
510 ev->total_size, ev->flags, ev->data,
513 channel_data_free(ev);
516 Queue_Unlock(pc->cached_server_channel_data);
532static BOOL pf_client_post_connect(freerdp* instance)
534 WINPR_ASSERT(instance);
535 rdpContext* context = instance->context;
536 WINPR_ASSERT(context);
537 rdpUpdate* update = context->update;
538 WINPR_ASSERT(update);
539 pClientContext* pc = (pClientContext*)context;
541 WINPR_ASSERT(pc->pdata);
542 rdpContext* ps = (rdpContext*)pc->pdata->ps;
545 if (!pf_modules_run_hook(pc->pdata->module, HOOK_TYPE_CLIENT_POST_CONNECT, pc->pdata, pc))
548 if (!gdi_init(instance, PIXEL_FORMAT_BGRA32))
553 pf_client_register_update_callbacks(update);
556 pc->client_receive_channel_data_original = instance->ReceiveChannelData;
557 instance->ReceiveChannelData = pf_client_receive_channel_data_hook;
559 instance->heartbeat->ServerHeartbeat = pf_client_on_server_heartbeat;
561 pc->connected = TRUE;
564 if (!sendQueuedChannelData(pc))
572 return proxy_server_reactivate(ps, context);
578static void pf_client_post_disconnect(freerdp* instance)
580 pClientContext* pc =
nullptr;
581 proxyData* pdata =
nullptr;
586 if (!instance->context)
589 pc = (pClientContext*)instance->context;
594#if defined(WITH_PROXY_EMULATE_SMARTCARD)
595 pf_channel_smartcard_client_free(pc);
598 pf_channel_rdpdr_client_free(pc);
600 pc->connected = FALSE;
601 (void)pf_modules_run_hook(pc->pdata->module, HOOK_TYPE_CLIENT_POST_DISCONNECT, pc->pdata, pc);
603 PubSub_UnsubscribeErrorInfo(instance->context->pubSub, pf_client_on_error_info);
607 if (!pc->allow_next_conn_failure)
608 proxy_data_abort_connect(pdata);
612static BOOL pf_client_redirect(freerdp* instance)
617 if (!instance->context)
620 pClientContext* pc = (pClientContext*)instance->context;
623#if defined(WITH_PROXY_EMULATE_SMARTCARD)
624 pf_channel_smartcard_client_reset(pc);
626 pf_channel_rdpdr_client_reset(pc);
628 return pf_modules_run_hook(pc->pdata->module, HOOK_TYPE_CLIENT_REDIRECT, pc->pdata, pc);
638static BOOL pf_client_should_retry_without_nla(pClientContext* pc)
640 rdpSettings* settings =
nullptr;
641 const proxyConfig* config =
nullptr;
644 WINPR_ASSERT(pc->pdata);
645 settings = pc->context.settings;
646 WINPR_ASSERT(settings);
647 config = pc->pdata->config;
648 WINPR_ASSERT(config);
650 if (!config->ClientAllowFallbackToTls ||
654 return config->ClientTlsSecurity || config->ClientRdpSecurity;
658static BOOL pf_client_set_security_settings(pClientContext* pc)
661 WINPR_ASSERT(pc->pdata);
662 rdpSettings* settings = pc->context.settings;
663 WINPR_ASSERT(settings);
664 const proxyConfig* config = pc->pdata->config;
665 WINPR_ASSERT(config);
674 if (pf_client_use_proxy_smartcard_auth(settings))
691static BOOL pf_client_connect_without_nla(pClientContext* pc)
693 freerdp* instance =
nullptr;
694 rdpSettings* settings =
nullptr;
697 instance = pc->context.instance;
698 WINPR_ASSERT(instance);
700 if (!freerdp_context_reset(instance))
703 settings = pc->context.settings;
704 WINPR_ASSERT(settings);
715 pc->allow_next_conn_failure = FALSE;
716 return freerdp_connect(instance);
720static BOOL pf_client_connect(freerdp* instance)
722 pClientContext* pc =
nullptr;
723 rdpSettings* settings =
nullptr;
727 WINPR_ASSERT(instance);
728 pc = (pClientContext*)instance->context;
730 settings = instance->context->settings;
731 WINPR_ASSERT(settings);
733 if (!pf_client_set_security_settings(pc))
736 if (pf_client_should_retry_without_nla(pc))
737 retry = pc->allow_next_conn_failure = TRUE;
739 PROXY_LOG_INFO(TAG, pc,
"connecting using client info: Username: %s, Domain: %s",
742 PROXY_LOG_INFO(TAG, pc,
"connecting using security settings: rdp=%d, tls=%d, nla=%d",
747 if (!freerdp_connect(instance))
749 if (!pf_modules_run_hook(pc->pdata->module, HOOK_TYPE_CLIENT_LOGIN_FAILURE, pc->pdata, pc))
755 PROXY_LOG_ERR(TAG, pc,
"failed to connect with NLA. retrying to connect without NLA");
756 if (!pf_client_connect_without_nla(pc))
758 PROXY_LOG_ERR(TAG, pc,
"pf_client_connect_without_nla failed!");
765 pc->allow_next_conn_failure = FALSE;
775static DWORD WINAPI pf_client_thread_proc(pClientContext* pc)
777 freerdp* instance =
nullptr;
778 proxyData* pdata =
nullptr;
781 HANDLE handles[MAXIMUM_WAIT_OBJECTS] = WINPR_C_ARRAY_INIT;
785 instance = pc->context.instance;
786 WINPR_ASSERT(instance);
797 handles[nCount++] = pdata->abort_event;
799 if (!pf_modules_run_hook(pdata->module, HOOK_TYPE_CLIENT_INIT_CONNECT, pdata, pc))
801 proxy_data_abort_connect(pdata);
805 if (!pf_client_connect(instance))
807 proxy_data_abort_connect(pdata);
810 handles[nCount++] = Queue_Event(pc->cached_server_channel_data);
812 while (!freerdp_shall_disconnect_context(instance->context))
814 UINT32 tmp = freerdp_get_event_handles(instance->context, &handles[nCount],
815 ARRAYSIZE(handles) - nCount);
819 PROXY_LOG_ERR(TAG, pc,
"freerdp_get_event_handles failed!");
823 status = WaitForMultipleObjects(nCount + tmp, handles, FALSE, INFINITE);
825 if (status == WAIT_FAILED)
827 WLog_ERR(TAG,
"WaitForMultipleObjects failed with %" PRIu32
"", status);
832 if (status == WAIT_OBJECT_0)
835 if (freerdp_shall_disconnect_context(instance->context))
838 if (proxy_data_shall_disconnect(pdata))
841 if (!freerdp_check_event_handles(instance->context))
843 if (freerdp_get_last_error(instance->context) == FREERDP_ERROR_SUCCESS)
844 WLog_ERR(TAG,
"Failed to check FreeRDP event handles");
848 if (!sendQueuedChannelData(pc))
852 freerdp_disconnect(instance);
855 (void)pf_modules_run_hook(pdata->module, HOOK_TYPE_CLIENT_UNINIT_CONNECT, pdata, pc);
861static int pf_logon_error_info(freerdp* instance, UINT32 data, UINT32 type)
863 const char* str_data = freerdp_get_logon_error_info_data(data);
864 const char* str_type = freerdp_get_logon_error_info_type(type);
866 if (!instance || !instance->context)
869 WLog_INFO(TAG,
"Logon Error Info %s [%s]", str_data, str_type);
873static void pf_client_context_free(freerdp* instance, rdpContext* context)
875 pClientContext* pc = (pClientContext*)context;
876 WINPR_UNUSED(instance);
881 pc->sendChannelData =
nullptr;
882 Queue_Free(pc->cached_server_channel_data);
883 Stream_Free(pc->remote_pem, TRUE);
884 free(pc->remote_hostname);
885 free(pc->computerName.v);
886 HashTable_Free(pc->interceptContextMap);
890static int pf_client_verify_X509_certificate(freerdp* instance,
const BYTE* data,
size_t length,
891 const char* hostname, UINT16 port, DWORD flags)
893 pClientContext* pc =
nullptr;
895 WINPR_ASSERT(instance);
897 WINPR_ASSERT(length > 0);
898 WINPR_ASSERT(hostname);
900 pc = (pClientContext*)instance->context;
903 if (!Stream_EnsureCapacity(pc->remote_pem, length))
905 Stream_ResetPosition(pc->remote_pem);
907 free(pc->remote_hostname);
908 pc->remote_hostname =
nullptr;
911 Stream_Write(pc->remote_pem, data, length);
914 pc->remote_hostname = _strdup(hostname);
915 pc->remote_port = port;
916 pc->remote_flags = flags;
918 Stream_SealLength(pc->remote_pem);
919 if (!pf_modules_run_hook(pc->pdata->module, HOOK_TYPE_CLIENT_VERIFY_X509, pc->pdata, pc))
925static BOOL pf_client_choose_smartcard(WINPR_ATTR_UNUSED freerdp* instance,
927 WINPR_ATTR_UNUSED DWORD count, DWORD* choice,
928 WINPR_ATTR_UNUSED BOOL gateway)
937static BOOL pf_client_authenticate_ex(WINPR_ATTR_UNUSED freerdp* instance,
938 WINPR_ATTR_UNUSED
char** username,
939 WINPR_ATTR_UNUSED
char** password,
940 WINPR_ATTR_UNUSED
char** domain, rdp_auth_reason reason)
942 WINPR_ASSERT(instance);
943 WINPR_ASSERT(username);
944 WINPR_ASSERT(password);
945 WINPR_ASSERT(domain);
955 case AUTH_SMARTCARD_PIN:
966static BOOL pf_client_present_gateway_message(WINPR_ATTR_UNUSED freerdp* instance,
967 WINPR_ATTR_UNUSED UINT32 type,
968 WINPR_ATTR_UNUSED BOOL isDisplayMandatory,
969 WINPR_ATTR_UNUSED BOOL isConsentMandatory,
970 WINPR_ATTR_UNUSED
size_t length,
971 WINPR_ATTR_UNUSED
const WCHAR* message)
973 WLog_WARN(TAG,
"TODO: Implement gateway message forwarding");
977void channel_data_free(
void* obj)
990 cnv.cpv = dst->channel_name;
996WINPR_ATTR_MALLOC(channel_data_free, 1)
998static
void* channel_data_copy(const
void* obj)
1015 if (src->channel_name)
1017 dst->channel_name = _strdup(src->channel_name);
1018 if (!dst->channel_name)
1021 dst->data = malloc(src->data_len);
1025 cnv.cpv = dst->data;
1026 memcpy(cnv.pv, src->data, src->data_len);
1030 channel_data_free(dst);
1035static BOOL pf_client_client_new(freerdp* instance, rdpContext* context)
1038 pClientContext* pc = (pClientContext*)context;
1040 if (!instance || !context)
1043 instance->LoadChannels = pf_client_load_channels;
1044 instance->PreConnect = pf_client_pre_connect;
1045 instance->PostConnect = pf_client_post_connect;
1046 instance->PostDisconnect = pf_client_post_disconnect;
1047 instance->Redirect = pf_client_redirect;
1048 instance->LogonErrorInfo = pf_logon_error_info;
1049 instance->GetAccessToken =
nullptr;
1050 instance->RetryDialog =
nullptr;
1051 instance->VerifyCertificateEx =
nullptr;
1052 instance->VerifyChangedCertificateEx =
nullptr;
1053 instance->VerifyX509Certificate = pf_client_verify_X509_certificate;
1054 instance->AuthenticateEx = pf_client_authenticate_ex;
1055 instance->ChooseSmartcard = pf_client_choose_smartcard;
1056 instance->PresentGatewayMessage = pf_client_present_gateway_message;
1058 pc->remote_pem = Stream_New(
nullptr, 4096);
1059 if (!pc->remote_pem)
1062 pc->sendChannelData = pf_client_send_channel_data;
1063 pc->cached_server_channel_data = Queue_New(TRUE, -1, -1);
1064 if (!pc->cached_server_channel_data)
1066 obj = Queue_Object(pc->cached_server_channel_data);
1071 pc->interceptContextMap = HashTable_New(FALSE);
1072 if (!pc->interceptContextMap)
1075 if (!HashTable_SetupForStringData(pc->interceptContextMap, FALSE))
1078 obj = HashTable_ValueObject(pc->interceptContextMap);
1086static int pf_client_client_stop(rdpContext* context)
1088 pClientContext* pc = (pClientContext*)context;
1089 proxyData* pdata =
nullptr;
1093 WINPR_ASSERT(pdata);
1095 PROXY_LOG_DBG(TAG, pc,
"aborting client connection");
1096 proxy_data_abort_connect(pdata);
1097 freerdp_abort_connect_context(context);
1102int RdpClientEntry(RDP_CLIENT_ENTRY_POINTS* pEntryPoints)
1104 WINPR_ASSERT(pEntryPoints);
1106 ZeroMemory(pEntryPoints,
sizeof(RDP_CLIENT_ENTRY_POINTS));
1107 pEntryPoints->Version = RDP_CLIENT_INTERFACE_VERSION;
1108 pEntryPoints->Size =
sizeof(RDP_CLIENT_ENTRY_POINTS_V1);
1109 pEntryPoints->ContextSize =
sizeof(pClientContext);
1111 pEntryPoints->ClientNew = pf_client_client_new;
1112 pEntryPoints->ClientFree = pf_client_context_free;
1113 pEntryPoints->ClientStop = pf_client_client_stop;
1120DWORD WINAPI pf_client_start(LPVOID arg)
1123 pClientContext* pc = (pClientContext*)arg;
1126 if (freerdp_client_start(&pc->context) == 0)
1127 rc = pf_client_thread_proc(pc);
1128 freerdp_client_stop(&pc->context);
WINPR_ATTR_NODISCARD FREERDP_API const char * freerdp_settings_get_string(const rdpSettings *settings, FreeRDP_Settings_Keys_String id)
Returns a immutable string settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_bool(rdpSettings *settings, FreeRDP_Settings_Keys_Bool id, BOOL val)
Sets a BOOL settings value.
WINPR_ATTR_NODISCARD FREERDP_API void * freerdp_settings_get_pointer_writable(rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id)
Returns a mutable pointer settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_uint32(rdpSettings *settings, FreeRDP_Settings_Keys_UInt32 id, UINT32 val)
Sets a UINT32 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_pointer_len(rdpSettings *settings, FreeRDP_Settings_Keys_Pointer id, const void *data, size_t len)
Set a pointer to value data.
WINPR_ATTR_NODISCARD FREERDP_API UINT32 freerdp_settings_get_uint32(const rdpSettings *settings, FreeRDP_Settings_Keys_UInt32 id)
Returns a UINT32 settings value.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_set_string(rdpSettings *settings, FreeRDP_Settings_Keys_String id, const char *val)
Sets a string settings value. The param is copied.
WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_settings_get_bool(const rdpSettings *settings, FreeRDP_Settings_Keys_Bool id)
Returns a boolean settings value.
This struct contains function pointer to initialize/free objects.
OBJECT_FREE_FN fnObjectFree
WINPR_ATTR_NODISCARD OBJECT_NEW_FN fnObjectNew