22#include <freerdp/config.h>
35#include "connection.h"
37#include <freerdp/buildflags.h>
38#include "gateway/rpc_fault.h"
40#include <winpr/assert.h>
43#include <winpr/string.h>
44#include <winpr/stream.h>
45#include <winpr/wtsapi.h>
47#include <winpr/debug.h>
49#include <freerdp/freerdp.h>
50#include <freerdp/streamdump.h>
51#include <freerdp/error.h>
52#include <freerdp/event.h>
53#include <freerdp/locale/keyboard.h>
54#include <freerdp/locale/locale.h>
55#include <freerdp/channels/channels.h>
56#include <freerdp/version.h>
57#include <freerdp/log.h>
58#include <freerdp/utils/signal.h>
60#include "../cache/pointer.h"
63#define TAG FREERDP_TAG("core")
65static void sig_abort_connect(
int signum,
const char* signame,
void* ctx)
67 rdpContext* context = (rdpContext*)ctx;
69 WLog_INFO(TAG,
"Signal %s [%d], terminating session %p", signame, signum,
70 WINPR_CXX_COMPAT_CAST(
const void*, context));
72 freerdp_abort_connect_context(context);
86static int freerdp_connect_begin(freerdp* instance)
89 rdpRdp* rdp =
nullptr;
91 rdpSettings* settings =
nullptr;
96 WINPR_ASSERT(instance->context);
99 instance->ConnectionCallbackState = CLIENT_STATE_INITIAL;
100 freerdp_set_last_error_log(instance->context, FREERDP_ERROR_SUCCESS);
101 clearChannelError(instance->context);
102 if (!utils_reset_abort(instance->context->rdp))
105 rdp = instance->context->rdp;
108 settings = instance->context->settings;
109 WINPR_ASSERT(settings);
111 freerdp_channels_register_instance(instance->context->channels, instance);
113 if (!freerdp_settings_set_default_order_support(settings))
116 if (!freerdp_add_signal_cleanup_handler(instance->context, sig_abort_connect))
119 IFCALLRET(instance->PreConnect, status, instance);
120 instance->ConnectionCallbackState = CLIENT_STATE_PRECONNECT_PASSED;
122 freerdp_settings_print_warnings(settings);
124 status = freerdp_settings_enforce_monitor_exists(settings);
127 status = freerdp_settings_enforce_consistency(settings);
130 status = freerdp_settings_check_client_after_preconnect(settings);
133 status = rdp_set_backup_settings(rdp);
135 status = utils_reload_channels(instance->context);
138 int64_t KeyboardLayout = freerdp_get_keyboard_default_layout_for_locale(cp);
139 if (KeyboardLayout == 0)
142 switch (KeyboardLayout)
145 case KBD_JAPANESE_INPUT_SYSTEM_MS_IME2002:
148 WINPR_KBD_TYPE_JAPANESE))
162 rdpContext* context = instance->context;
163 WINPR_ASSERT(context);
164 freerdp_set_last_error_if_not(context, FREERDP_ERROR_PRE_CONNECT_FAILED);
166 WLog_Print(context->log, WLOG_ERROR,
"freerdp_pre_connect failed: %s",
167 rdp_client_connection_state_string(instance->ConnectionCallbackState));
171 rc = rdp_client_connect(rdp);
176 rdpContext* context = rdp->context;
177 WINPR_ASSERT(context);
178 WLog_Print(context->log, WLOG_ERROR,
"Authentication only, exit status %" PRId32
"", rc);
185BOOL freerdp_connect(freerdp* instance)
188 ConnectionResultEventArgs e = WINPR_C_ARRAY_INIT;
189 const int rc = freerdp_connect_begin(instance);
190 rdpRdp* rdp =
nullptr;
191 UINT status2 = ERROR_INTERNAL_ERROR;
193 WINPR_ASSERT(instance);
194 WINPR_ASSERT(instance->context);
196 rdp = instance->context->rdp;
198 WINPR_ASSERT(rdp->settings);
207 up->pcap_rfx = pcap_open(
214 pointer_cache_register_callbacks(instance->context->update);
215 status = IFCALLRESULT(TRUE, instance->PostConnect, instance);
216 instance->ConnectionCallbackState = CLIENT_STATE_POSTCONNECT_PASSED;
219 status2 = freerdp_channels_post_connect(instance->context->channels, instance);
223 status2 = CHANNEL_RC_OK;
224 if (freerdp_get_last_error(instance->context) == FREERDP_ERROR_CONNECT_TRANSPORT_FAILED)
225 status = freerdp_reconnect(instance);
227 goto freerdp_connect_finally;
230 if (!status || (status2 != CHANNEL_RC_OK) || !update_post_connect(instance->context->update))
232 rdpContext* context = instance->context;
233 WINPR_ASSERT(context);
234 WLog_Print(context->log, WLOG_ERROR,
"freerdp_post_connect failed");
236 freerdp_set_last_error_if_not(context, FREERDP_ERROR_POST_CONNECT_FAILED);
239 goto freerdp_connect_finally;
242 if (rdp->settings->PlayRemoteFx)
246 pcap_record record = WINPR_C_ARRAY_INIT;
248 WINPR_ASSERT(update);
249 update->pcap_rfx = pcap_open(rdp->settings->PlayRemoteFxFile, FALSE);
252 if (!update->pcap_rfx)
253 goto freerdp_connect_finally;
255 update->play_rfx = TRUE;
259 while (pcap_has_next_record(update->pcap_rfx) && status)
261 if (!pcap_get_next_record_header(update->pcap_rfx, &record))
264 s = transport_take_from_pool(rdp->transport, record.length);
268 record.data = Stream_Buffer(s);
269 if (!pcap_get_next_record_content(update->pcap_rfx, &record))
271 Stream_SetLength(s, record.length);
272 Stream_SetPosition(s, 0);
274 if (!update_begin_paint(&update->common))
278 if (update_recv_surfcmds(&update->common, s) < 0)
281 if (!update_end_paint(&update->common))
288 pcap_close(update->pcap_rfx);
289 update->pcap_rfx =
nullptr;
290 goto freerdp_connect_finally;
293 if (rdp->errorInfo == ERRINFO_SERVER_INSUFFICIENT_PRIVILEGES)
294 freerdp_set_last_error_log(instance->context, FREERDP_ERROR_INSUFFICIENT_PRIVILEGES);
297 status = transport_set_connected_event(rdp->transport);
299freerdp_connect_finally:
300 EventArgsInit(&e,
"freerdp");
301 e.result = status ? 0 : -1;
302 PubSub_OnConnectionResult(rdp->pubSub, instance->context, &e);
305 freerdp_disconnect(instance);
310#if !defined(WITHOUT_FREERDP_3x_DEPRECATED)
311BOOL freerdp_abort_connect(freerdp* instance)
316 return freerdp_abort_connect_context(instance->context);
320BOOL freerdp_abort_connect_context(rdpContext* context)
325 freerdp_set_last_error_if_not(context, FREERDP_ERROR_CONNECT_CANCELLED);
326 return utils_abort_connect(context->rdp);
329#if defined(WITH_FREERDP_DEPRECATED)
330BOOL freerdp_get_fds(freerdp* instance,
void** rfds,
int* rcount, WINPR_ATTR_UNUSED
void** wfds,
331 WINPR_ATTR_UNUSED
int* wcount)
333 rdpRdp* rdp =
nullptr;
335 WINPR_ASSERT(instance);
336 WINPR_ASSERT(instance->context);
338 rdp = instance->context->rdp;
341 transport_get_fds(rdp->transport, rfds, rcount);
346BOOL freerdp_check_fds(freerdp* instance)
349 rdpRdp* rdp =
nullptr;
354 if (!instance->context)
357 if (!instance->context->rdp)
360 rdp = instance->context->rdp;
361 status = rdp_check_fds(rdp);
365 TerminateEventArgs e;
366 rdpContext* context = instance->context;
367 WINPR_ASSERT(context);
369 WLog_Print(context->log, WLOG_DEBUG,
"rdp_check_fds() - %i", status);
370 EventArgsInit(&e,
"freerdp");
372 PubSub_OnTerminate(rdp->pubSub, context, &e);
379DWORD freerdp_get_event_handles(rdpContext* context, HANDLE* events, DWORD count)
383 WINPR_ASSERT(context);
384 WINPR_ASSERT(context->rdp);
385 WINPR_ASSERT(events || (count == 0));
387 const size_t rrc = rdp_get_event_handles(context->rdp, &events[nCount], count - nCount);
391 nCount += WINPR_ASSERTING_INT_CAST(uint32_t, rrc);
393 if (events && (nCount < count + 2))
395 events[nCount++] = freerdp_channels_get_event_handle(context->instance);
396 events[nCount++] = getChannelErrorEventHandle(context);
401 const SSIZE_T rc = freerdp_client_channel_get_registered_event_handles(
402 context->channels, &events[nCount], count - nCount);
405 return nCount + (DWORD)rc;
409static BOOL freerdp_prevent_session_lock(rdpContext* context)
411 WINPR_ASSERT(context);
412 WINPR_ASSERT(context->input);
416 UINT32 FakeMouseMotionInterval =
418 if (FakeMouseMotionInterval && in->lastInputTimestamp)
420 const time_t now = time(
nullptr);
421 if (WINPR_ASSERTING_INT_CAST(
size_t, now) - in->lastInputTimestamp >
422 FakeMouseMotionInterval)
424 WLog_Print(context->log, WLOG_DEBUG,
425 "fake mouse move: x=%d y=%d lastInputTimestamp=%" PRIu64
" "
426 "FakeMouseMotionInterval=%" PRIu32,
427 in->lastX, in->lastY, in->lastInputTimestamp, FakeMouseMotionInterval);
429 BOOL status = freerdp_input_send_mouse_event(context->input, PTR_FLAGS_MOVE, in->lastX,
433 if (freerdp_get_last_error(context) == FREERDP_ERROR_SUCCESS)
434 WLog_Print(context->log, WLOG_ERROR,
435 "freerdp_prevent_session_lock() failed - %" PRIi32
"", status);
447BOOL freerdp_check_event_handles(rdpContext* context)
449 WINPR_ASSERT(context);
451 BOOL status = freerdp_check_fds(context->instance);
455 if (freerdp_get_last_error(context) == FREERDP_ERROR_SUCCESS)
456 WLog_Print(context->log, WLOG_ERROR,
"freerdp_check_fds() failed - %" PRIi32
"",
462 status = freerdp_channels_check_fds(context->channels, context->instance);
466 if (freerdp_get_last_error(context) == FREERDP_ERROR_SUCCESS)
467 WLog_Print(context->log, WLOG_ERROR,
468 "freerdp_channels_check_fds() failed - %" PRIi32
"", status);
473 status = checkChannelErrorEvent(context);
477 if (freerdp_get_last_error(context) == FREERDP_ERROR_SUCCESS)
478 WLog_Print(context->log, WLOG_ERROR,
"checkChannelErrorEvent() failed - %" PRIi32
"",
484 status = freerdp_prevent_session_lock(context);
489wMessageQueue* freerdp_get_message_queue(freerdp* instance, DWORD
id)
491 wMessageQueue* queue =
nullptr;
493 WINPR_ASSERT(instance);
495 rdpContext* context = instance->context;
496 WINPR_ASSERT(context);
500 case FREERDP_UPDATE_MESSAGE_QUEUE:
503 queue = update->queue;
507 case FREERDP_INPUT_MESSAGE_QUEUE:
510 queue = input->queue;
520HANDLE freerdp_get_message_queue_event_handle(freerdp* instance, DWORD
id)
522 HANDLE
event =
nullptr;
523 wMessageQueue* queue = freerdp_get_message_queue(instance,
id);
526 event = MessageQueue_Event(queue);
531int freerdp_message_queue_process_message(freerdp* instance, DWORD
id, wMessage* message)
534 rdpContext* context =
nullptr;
536 WINPR_ASSERT(instance);
538 context = instance->context;
539 WINPR_ASSERT(context);
543 case FREERDP_UPDATE_MESSAGE_QUEUE:
544 status = update_message_queue_process_message(context->update, message);
547 case FREERDP_INPUT_MESSAGE_QUEUE:
548 status = input_message_queue_process_message(context->input, message);
557int freerdp_message_queue_process_pending_messages(freerdp* instance, DWORD
id)
560 rdpContext* context =
nullptr;
562 WINPR_ASSERT(instance);
564 context = instance->context;
565 WINPR_ASSERT(context);
569 case FREERDP_UPDATE_MESSAGE_QUEUE:
570 status = update_message_queue_process_pending_messages(context->update);
573 case FREERDP_INPUT_MESSAGE_QUEUE:
574 status = input_message_queue_process_pending_messages(context->input);
583static BOOL freerdp_send_channel_data(freerdp* instance, UINT16 channelId,
const BYTE* data,
586 WINPR_ASSERT(instance);
587 WINPR_ASSERT(instance->context);
588 WINPR_ASSERT(instance->context->rdp);
589 return rdp_send_channel_data(instance->context->rdp, channelId, data, size);
592static BOOL freerdp_send_channel_packet(freerdp* instance, UINT16 channelId,
size_t totalSize,
593 UINT32 flags,
const BYTE* data,
size_t chunkSize)
595 WINPR_ASSERT(instance);
596 WINPR_ASSERT(instance->context);
597 WINPR_ASSERT(instance->context->rdp);
598 return rdp_channel_send_packet(instance->context->rdp, channelId, totalSize, flags, data,
602BOOL freerdp_disconnect(freerdp* instance)
606 if (!instance || !instance->context)
609 rdpRdp* rdp = instance->context->rdp;
614 if (freerdp_get_last_error(instance->context) == FREERDP_ERROR_CONNECT_CANCELLED)
616 (void)mcs_send_disconnect_provider_ultimatum(rdp->mcs,
617 Disconnect_Ultimatum_user_requested);
621 utils_abort_connect(rdp);
623 if (!rdp_client_disconnect(rdp))
627 if (rdp && rdp->update)
629 up = update_cast(rdp->update);
631 update_post_disconnect(rdp->update);
634 IFCALL(instance->PostDisconnect, instance);
640 up->dump_rfx = FALSE;
641 pcap_close(up->pcap_rfx);
642 up->pcap_rfx =
nullptr;
646 if (instance->context->channels)
647 freerdp_channels_close(instance->context->channels, instance);
649 IFCALL(instance->PostFinalDisconnect, instance);
651 freerdp_del_signal_cleanup_handler(instance->context, sig_abort_connect);
655#if !defined(WITHOUT_FREERDP_3x_DEPRECATED)
656BOOL freerdp_disconnect_before_reconnect(freerdp* instance)
658 WINPR_ASSERT(instance);
659 return freerdp_disconnect_before_reconnect_context(instance->context);
663BOOL freerdp_disconnect_before_reconnect_context(rdpContext* context)
665 rdpRdp* rdp =
nullptr;
667 WINPR_ASSERT(context);
670 return rdp_client_disconnect_and_clear(rdp);
673BOOL freerdp_reconnect(freerdp* instance)
675 rdpRdp* rdp =
nullptr;
677 WINPR_ASSERT(instance);
678 WINPR_ASSERT(instance->context);
680 if (freerdp_get_last_error(instance->context) == FREERDP_ERROR_CONNECT_CANCELLED)
683 rdp = instance->context->rdp;
685 if (!utils_reset_abort(instance->context->rdp))
687 return rdp_client_reconnect(rdp);
690#if !defined(WITHOUT_FREERDP_3x_DEPRECATED)
691BOOL freerdp_shall_disconnect(
const freerdp* instance)
696 return freerdp_shall_disconnect_context(instance->context);
700BOOL freerdp_shall_disconnect_context(
const rdpContext* context)
705 return utils_abort_event_is_set(context->rdp);
708BOOL freerdp_focus_required(freerdp* instance)
710 rdpRdp* rdp =
nullptr;
711 BOOL bRetCode = FALSE;
713 WINPR_ASSERT(instance);
714 WINPR_ASSERT(instance->context);
716 rdp = instance->context->rdp;
719 if (rdp->resendFocus)
722 rdp->resendFocus = FALSE;
728void freerdp_set_focus(freerdp* instance)
730 rdpRdp* rdp =
nullptr;
732 WINPR_ASSERT(instance);
733 WINPR_ASSERT(instance->context);
735 rdp = instance->context->rdp;
738 rdp->resendFocus = TRUE;
741void freerdp_get_version(
int* major,
int* minor,
int* revision)
743 if (major !=
nullptr)
744 *major = FREERDP_VERSION_MAJOR;
746 if (minor !=
nullptr)
747 *minor = FREERDP_VERSION_MINOR;
749 if (revision !=
nullptr)
750 *revision = FREERDP_VERSION_REVISION;
753const char* freerdp_get_version_string(
void)
755 return FREERDP_VERSION_FULL;
758const char* freerdp_get_build_config(
void)
760 WINPR_PRAGMA_DIAG_PUSH
761 WINPR_PRAGMA_DIAG_IGNORED_OVERLENGTH_STRINGS
762 static const char build_config[] =
763 "Build configuration: " FREERDP_BUILD_CONFIG
"\n"
764 "Build type: " FREERDP_BUILD_TYPE
"\n"
765 "CFLAGS: " FREERDP_CFLAGS
"\n"
766 "Compiler: " FREERDP_COMPILER_ID
", " FREERDP_COMPILER_VERSION
"\n"
767 "Target architecture: " FREERDP_TARGET_ARCH
"\n";
768 WINPR_PRAGMA_DIAG_POP
772const char* freerdp_get_build_revision(
void)
774 return FREERDP_GIT_REVISION;
778 DEFINE_EVENT_ENTRY(WindowStateChange), DEFINE_EVENT_ENTRY(ResizeWindow),
779 DEFINE_EVENT_ENTRY(LocalResizeWindow), DEFINE_EVENT_ENTRY(EmbedWindow),
780 DEFINE_EVENT_ENTRY(PanningChange), DEFINE_EVENT_ENTRY(ZoomingChange),
781 DEFINE_EVENT_ENTRY(ErrorInfo), DEFINE_EVENT_ENTRY(Terminate),
782 DEFINE_EVENT_ENTRY(ConnectionResult), DEFINE_EVENT_ENTRY(ChannelConnected),
783 DEFINE_EVENT_ENTRY(ChannelDisconnected), DEFINE_EVENT_ENTRY(MouseEvent),
784 DEFINE_EVENT_ENTRY(Activated), DEFINE_EVENT_ENTRY(Timer),
785 DEFINE_EVENT_ENTRY(GraphicsReset)
798BOOL freerdp_context_new(freerdp* instance)
800 return freerdp_context_new_ex(instance,
nullptr);
803static BOOL freerdp_common_context(rdpContext* context, AccessTokenType tokenType,
char** token,
808 WINPR_ASSERT(context);
809 if (!context->instance || !context->instance->GetAccessToken)
812 va_list ap = WINPR_C_ARRAY_INIT;
816 case ACCESS_TOKEN_TYPE_AAD:
820 "ACCESS_TOKEN_TYPE_AAD expected 2 additional arguments, but got %" PRIuz
826 const char* scope = va_arg(ap,
const char*);
827 const char* req_cnf = va_arg(ap,
const char*);
828 rc = context->instance->GetAccessToken(context->instance, tokenType, token, count,
832 case ACCESS_TOKEN_TYPE_AVD:
836 "ACCESS_TOKEN_TYPE_AVD expected 0 additional arguments, but got %" PRIuz
842 rc = context->instance->GetAccessToken(context->instance, tokenType, token, count);
851 freerdp_set_last_error_if_not(context, FREERDP_ERROR_CONNECT_ACCESS_DENIED);
856BOOL freerdp_context_new_ex(freerdp* instance, rdpSettings* settings)
858 rdpRdp* rdp =
nullptr;
859 rdpContext* context =
nullptr;
862 WINPR_ASSERT(instance);
864 instance->context = context = (rdpContext*)calloc(1, instance->ContextSize);
869 context->log = WLog_Get(TAG);
874 context->settings = settings;
875 context->instance = instance;
876 context->ServerMode = FALSE;
877 context->disconnectUltimatum = 0;
879 context->metrics = metrics_new(context);
881 if (!context->metrics)
884 rdp = rdp_new(context);
890 context->pubSub = rdp->pubSub;
892 if (!context->pubSub)
895 PubSub_AddEventTypes(rdp->pubSub, FreeRDP_Events, ARRAYSIZE(FreeRDP_Events));
897#if defined(WITH_FREERDP_DEPRECATED)
898 instance->input = rdp->input;
899 instance->update = rdp->update;
900 instance->settings = rdp->settings;
901 instance->autodetect = rdp->autodetect;
904 instance->heartbeat = rdp->heartbeat;
905 context->graphics = graphics_new(context);
907 if (!context->graphics)
910 context->input = rdp->input;
911 context->update = rdp->update;
912 context->settings = rdp->settings;
913 context->autodetect = rdp->autodetect;
915 if (!(context->errorDescription = calloc(1, 500)))
917 WLog_Print(context->log, WLOG_ERROR,
"calloc failed!");
921 if (!(context->channelErrorEvent = CreateEvent(
nullptr, TRUE, FALSE,
nullptr)))
923 WLog_Print(context->log, WLOG_ERROR,
"CreateEvent failed!");
927 update_register_client_callbacks(rdp->update);
929 if (!(context->channels = freerdp_channels_new(instance)))
932 context->dump = stream_dump_new();
940 if (!freerdp_set_common_access_token(context, freerdp_common_context))
943 IFCALLRET(instance->ContextNew, ret, instance, context);
951 freerdp_context_free(instance);
955BOOL freerdp_context_reset(freerdp* instance)
960 WINPR_ASSERT(instance->context);
961 rdpRdp* rdp = instance->context->rdp;
963 return rdp_reset_runtime_settings(rdp);
974void freerdp_context_free(freerdp* instance)
976 rdpContext* ctx =
nullptr;
981 if (!instance->context)
984 ctx = instance->context;
986 IFCALL(instance->ContextFree, instance, ctx);
989 ctx->settings =
nullptr;
991 graphics_free(ctx->graphics);
992 ctx->graphics =
nullptr;
994 metrics_free(ctx->metrics);
995 ctx->metrics =
nullptr;
997 if (ctx->channelErrorEvent)
998 (void)CloseHandle(ctx->channelErrorEvent);
999 ctx->channelErrorEvent =
nullptr;
1001 free(ctx->errorDescription);
1002 ctx->errorDescription =
nullptr;
1004 freerdp_channels_free(ctx->channels);
1005 ctx->channels =
nullptr;
1007 freerdp_client_codecs_free(ctx->codecs);
1008 ctx->codecs =
nullptr;
1010 stream_dump_free(ctx->dump);
1011 ctx->dump =
nullptr;
1013 ctx->input =
nullptr;
1014 ctx->update =
nullptr;
1015 ctx->settings =
nullptr;
1016 ctx->autodetect =
nullptr;
1019 instance->context =
nullptr;
1020#if defined(WITH_FREERDP_DEPRECATED)
1021 instance->input =
nullptr;
1022 instance->update =
nullptr;
1023 instance->settings =
nullptr;
1024 instance->autodetect =
nullptr;
1026 instance->heartbeat =
nullptr;
1029int freerdp_get_disconnect_ultimatum(
const rdpContext* context)
1031 WINPR_ASSERT(context);
1032 return context->disconnectUltimatum;
1035UINT32 freerdp_error_info(
const freerdp* instance)
1037 WINPR_ASSERT(instance);
1038 WINPR_ASSERT(instance->context);
1039 WINPR_ASSERT(instance->context->rdp);
1040 return instance->context->rdp->errorInfo;
1043void freerdp_set_error_info(rdpRdp* rdp, UINT32 error)
1048 rdp_set_error_info(rdp, error);
1051BOOL freerdp_send_error_info(rdpRdp* rdp)
1056 return rdp_send_error_info(rdp);
1059UINT32 freerdp_get_last_error(
const rdpContext* context)
1061 WINPR_ASSERT(context);
1062 return context->LastError;
1065const char* freerdp_get_last_error_name(UINT32 code)
1067 const char* name =
nullptr;
1068 const UINT32 cls = GET_FREERDP_ERROR_CLASS(code);
1069 const UINT32 type = GET_FREERDP_ERROR_TYPE(code);
1073 case FREERDP_ERROR_ERRBASE_CLASS:
1074 name = freerdp_get_error_base_name(type);
1077 case FREERDP_ERROR_ERRINFO_CLASS:
1078 name = freerdp_get_error_info_name(type);
1081 case FREERDP_ERROR_CONNECT_CLASS:
1082 name = freerdp_get_error_connect_name(type);
1086 name = rpc_error_to_string(code);
1093const char* freerdp_get_last_error_string(UINT32 code)
1095 const char*
string =
nullptr;
1096 const UINT32 cls = GET_FREERDP_ERROR_CLASS(code);
1097 const UINT32 type = GET_FREERDP_ERROR_TYPE(code);
1101 case FREERDP_ERROR_ERRBASE_CLASS:
1102 string = freerdp_get_error_base_string(type);
1105 case FREERDP_ERROR_ERRINFO_CLASS:
1106 string = freerdp_get_error_info_string(type);
1109 case FREERDP_ERROR_CONNECT_CLASS:
1110 string = freerdp_get_error_connect_string(type);
1114 string = rpc_error_to_string(code);
1121const char* freerdp_get_last_error_category(UINT32 code)
1123 const char*
string =
nullptr;
1124 const UINT32 cls = GET_FREERDP_ERROR_CLASS(code);
1125 const UINT32 type = GET_FREERDP_ERROR_TYPE(code);
1129 case FREERDP_ERROR_ERRBASE_CLASS:
1130 string = freerdp_get_error_base_category(type);
1133 case FREERDP_ERROR_ERRINFO_CLASS:
1134 string = freerdp_get_error_info_category(type);
1137 case FREERDP_ERROR_CONNECT_CLASS:
1138 string = freerdp_get_error_connect_category(type);
1142 string = rpc_error_to_category(code);
1149void freerdp_set_last_error_ex(rdpContext* context, UINT32 lastError,
const char* fkt,
1150 const char* file,
int line)
1152 WINPR_ASSERT(context);
1153 WINPR_ASSERT(line >= 0);
1157 if (WLog_IsLevelActive(context->log, WLOG_ERROR))
1159 WLog_PrintTextMessage(context->log, WLOG_ERROR, (
size_t)line, file, fkt,
1160 "%s [0x%08" PRIX32
"]", freerdp_get_last_error_name(lastError),
1165 if (lastError == FREERDP_ERROR_SUCCESS)
1167 if (WLog_IsLevelActive(context->log, WLOG_DEBUG))
1168 WLog_PrintTextMessage(context->log, WLOG_DEBUG, (
size_t)line, file, fkt,
1169 "resetting error state");
1171 else if (context->LastError != FREERDP_ERROR_SUCCESS)
1173 if (WLog_IsLevelActive(context->log, WLOG_ERROR))
1175 WLog_PrintTextMessage(context->log, WLOG_ERROR, (
size_t)line, file, fkt,
1176 "TODO: Trying to set error code %s, but %s already set!",
1177 freerdp_get_last_error_name(lastError),
1178 freerdp_get_last_error_name(context->LastError));
1181 context->LastError = lastError;
1184const char* freerdp_get_logon_error_info_type_ex(UINT32 type,
char* buffer,
size_t size)
1186 const char* str = freerdp_get_logon_error_info_type(type);
1187 (void)_snprintf(buffer, size,
"%s(0x%04" PRIx32
")", str, type);
1191const char* freerdp_get_logon_error_info_type(UINT32 type)
1193#define CASE_ENTRY(x) \
1198 CASE_ENTRY(LOGON_MSG_SESSION_BUSY_OPTIONS);
1199 CASE_ENTRY(LOGON_MSG_DISCONNECT_REFUSED);
1200 CASE_ENTRY(LOGON_MSG_NO_PERMISSION);
1201 CASE_ENTRY(LOGON_MSG_BUMP_OPTIONS);
1202 CASE_ENTRY(LOGON_MSG_RECONNECT_OPTIONS);
1203 CASE_ENTRY(LOGON_MSG_SESSION_TERMINATE);
1204 CASE_ENTRY(LOGON_MSG_SESSION_CONTINUE);
1205 CASE_ENTRY(ERROR_CODE_ACCESS_DENIED);
1213const char* freerdp_get_logon_error_info_data(UINT32 data)
1217 case LOGON_FAILED_BAD_PASSWORD:
1218 return "LOGON_FAILED_BAD_PASSWORD";
1220 case LOGON_FAILED_UPDATE_PASSWORD:
1221 return "LOGON_FAILED_UPDATE_PASSWORD";
1223 case LOGON_FAILED_OTHER:
1224 return "LOGON_FAILED_OTHER";
1227 return "LOGON_WARNING";
1230 return "SESSION_ID";
1234const char* freerdp_get_logon_error_info_data_ex(UINT32 data,
char* buffer,
size_t size)
1236 const char* str = freerdp_get_logon_error_info_data(data);
1237 (void)_snprintf(buffer, size,
"%s(0x%04" PRIx32
")", str, data);
1244freerdp* freerdp_new(
void)
1246 freerdp* instance =
nullptr;
1247 instance = (freerdp*)calloc(1,
sizeof(freerdp));
1252 instance->ContextSize =
sizeof(rdpContext);
1253 instance->SendChannelData = freerdp_send_channel_data;
1254 instance->SendChannelPacket = freerdp_send_channel_packet;
1255 instance->ReceiveChannelData = freerdp_channels_data;
1263void freerdp_free(freerdp* instance)
1268ULONG freerdp_get_transport_sent(
const rdpContext* context, BOOL resetCount)
1270 WINPR_ASSERT(context);
1271 WINPR_ASSERT(context->rdp);
1272 UINT64 rc = transport_get_bytes_sent(context->rdp->transport, resetCount);
1273 return WINPR_CXX_COMPAT_CAST(ULONG, MIN(rc, UINT32_MAX));
1276BOOL freerdp_nla_impersonate(rdpContext* context)
1278 rdpNla* nla =
nullptr;
1286 if (!context->rdp->transport)
1289 nla = transport_get_nla(context->rdp->transport);
1290 return nla_impersonate(nla);
1293BOOL freerdp_nla_revert_to_self(rdpContext* context)
1295 rdpNla* nla =
nullptr;
1303 if (!context->rdp->transport)
1306 nla = transport_get_nla(context->rdp->transport);
1307 return nla_revert_to_self(nla);
1310UINT32 freerdp_get_nla_sspi_error(
const rdpContext* context)
1312 WINPR_ASSERT(context);
1313 WINPR_ASSERT(context->rdp);
1314 WINPR_ASSERT(context->rdp->transport);
1316 rdpNla* nla = transport_get_nla(context->rdp->transport);
1317 return (UINT32)nla_get_sspi_error(nla);
1320BOOL freerdp_nla_encrypt(rdpContext* context,
const SecBuffer* inBuffer,
SecBuffer* outBuffer)
1322 WINPR_ASSERT(context);
1323 WINPR_ASSERT(context->rdp);
1325 rdpNla* nla = context->rdp->nla;
1326 return nla_encrypt(nla, inBuffer, outBuffer);
1329BOOL freerdp_nla_decrypt(rdpContext* context,
const SecBuffer* inBuffer,
SecBuffer* outBuffer)
1331 WINPR_ASSERT(context);
1332 WINPR_ASSERT(context->rdp);
1334 rdpNla* nla = context->rdp->nla;
1335 return nla_decrypt(nla, inBuffer, outBuffer);
1338SECURITY_STATUS freerdp_nla_QueryContextAttributes(rdpContext* context, DWORD ulAttr, PVOID pBuffer)
1340 WINPR_ASSERT(context);
1341 WINPR_ASSERT(context->rdp);
1343 rdpNla* nla = context->rdp->nla;
1345 nla = transport_get_nla(context->rdp->transport);
1349 return nla_QueryContextAttributes(nla, ulAttr, pBuffer);
1352SECURITY_STATUS freerdp_nla_FreeContextBuffer(rdpContext* context, PVOID pBuffer)
1354 WINPR_ASSERT(context);
1355 WINPR_ASSERT(context->rdp);
1357 rdpNla* nla = context->rdp->nla;
1359 nla = transport_get_nla(context->rdp->transport);
1363 return nla_FreeContextBuffer(nla, pBuffer);
1366HANDLE getChannelErrorEventHandle(rdpContext* context)
1368 WINPR_ASSERT(context);
1369 return context->channelErrorEvent;
1372BOOL checkChannelErrorEvent(rdpContext* context)
1374 WINPR_ASSERT(context);
1376 if (WaitForSingleObject(context->channelErrorEvent, 0) == WAIT_OBJECT_0)
1378 WLog_Print(context->log, WLOG_ERROR,
"%s. Error was %" PRIu32
"", context->errorDescription,
1379 context->channelErrorNum);
1391UINT getChannelError(
const rdpContext* context)
1393 WINPR_ASSERT(context);
1394 return context->channelErrorNum;
1397const char* getChannelErrorDescription(
const rdpContext* context)
1399 WINPR_ASSERT(context);
1400 return context->errorDescription;
1403void clearChannelError(rdpContext* context)
1405 WINPR_ASSERT(context);
1406 context->channelErrorNum = 0;
1407 memset(context->errorDescription, 0, 500);
1408 (void)ResetEvent(context->channelErrorEvent);
1411WINPR_ATTR_FORMAT_ARG(3, 4)
1412void setChannelError(rdpContext* context, UINT errorNum, WINPR_FORMAT_ARG const
char* format, ...)
1414 va_list ap = WINPR_C_ARRAY_INIT;
1415 va_start(ap, format);
1417 WINPR_ASSERT(context);
1419 context->channelErrorNum = errorNum;
1420 (void)vsnprintf(context->errorDescription, 499, format, ap);
1422 (void)SetEvent(context->channelErrorEvent);
1425const char* freerdp_nego_get_routing_token(
const rdpContext* context, DWORD* length)
1427 if (!context || !context->rdp)
1430 return (
const char*)nego_get_routing_token(context->rdp->nego, length);
1433BOOL freerdp_io_callback_set_event(rdpContext* context, BOOL set)
1435 WINPR_ASSERT(context);
1436 return rdp_io_callback_set_event(context->rdp, set);
1439const rdpTransportIo* freerdp_get_io_callbacks(rdpContext* context)
1441 WINPR_ASSERT(context);
1442 return rdp_get_io_callbacks(context->rdp);
1445BOOL freerdp_set_io_callbacks(rdpContext* context,
const rdpTransportIo* io_callbacks)
1447 WINPR_ASSERT(context);
1448 return rdp_set_io_callbacks(context->rdp, io_callbacks);
1451BOOL freerdp_set_io_callback_context(rdpContext* context,
void* usercontext)
1453 WINPR_ASSERT(context);
1454 return rdp_set_io_callback_context(context->rdp, usercontext);
1457void* freerdp_get_io_callback_context(rdpContext* context)
1459 WINPR_ASSERT(context);
1460 return rdp_get_io_callback_context(context->rdp);
1463CONNECTION_STATE freerdp_get_state(
const rdpContext* context)
1465 WINPR_ASSERT(context);
1466 return rdp_get_state(context->rdp);
1469const char* freerdp_state_string(CONNECTION_STATE state)
1471 return rdp_state_string(state);
1474BOOL freerdp_is_active_state(
const rdpContext* context)
1476 WINPR_ASSERT(context);
1477 return rdp_is_active_state(context->rdp);
1480BOOL freerdp_channels_from_mcs(rdpSettings* settings,
const rdpContext* context)
1482 WINPR_ASSERT(context);
1483 return rdp_channels_from_mcs(settings, context->rdp);
1486HANDLE freerdp_abort_event(rdpContext* context)
1488 WINPR_ASSERT(context);
1489 return utils_get_abort_event(context->rdp);
1492static void test_mcs_free(rdpMcs* mcs)
1499 rdpSettings* settings = mcs->context->settings;
1507static rdpMcs* test_mcs_new(
void)
1510 rdpContext* context = calloc(1,
sizeof(rdpContext));
1519 context->settings = settings;
1520 return mcs_new(context);
1529BOOL freerdp_is_valid_mcs_create_request(
const BYTE* data,
size_t size)
1532 wStream sbuffer = WINPR_C_ARRAY_INIT;
1533 wStream* s = Stream_StaticConstInit(&sbuffer, data, size);
1535 WINPR_ASSERT(data || (size == 0));
1538 rdpMcs* mcs = test_mcs_new();
1541 BOOL result = mcs_recv_connect_initial(mcs, s);
1546BOOL freerdp_is_valid_mcs_create_response(
const BYTE* data,
size_t size)
1549 wStream sbuffer = WINPR_C_ARRAY_INIT;
1550 wStream* s = Stream_StaticConstInit(&sbuffer, data, size);
1552 WINPR_ASSERT(data || (size == 0));
1555 rdpMcs* mcs = test_mcs_new();
1558 BOOL result = mcs_recv_connect_response(mcs, s);
1563BOOL freerdp_persist_credentials(rdpContext* context)
1567 WINPR_ASSERT(context->rdp);
1568 return utils_persist_credentials(context->rdp->originalSettings, context->rdp->settings);
1571const char* freerdp_disconnect_reason_string(
int reason)
1575 case Disconnect_Ultimatum_domain_disconnected:
1576 return "rn-domain-disconnected";
1577 case Disconnect_Ultimatum_provider_initiated:
1578 return "rn-provider-initiated";
1579 case Disconnect_Ultimatum_token_purged:
1580 return "rn-token-purged";
1581 case Disconnect_Ultimatum_user_requested:
1582 return "rn-user-requested";
1583 case Disconnect_Ultimatum_channel_purged:
1584 return "rn-channel-purged";
1586 return "rn-unknown";
1590BOOL freerdp_set_common_access_token(rdpContext* context,
1591 pGetCommonAccessToken GetCommonAccessToken)
1593 WINPR_ASSERT(context);
1594 WINPR_ASSERT(context->rdp);
1595 context->rdp->GetCommonAccessToken = GetCommonAccessToken;
1599pGetCommonAccessToken freerdp_get_common_access_token(
const rdpContext* context)
1601 WINPR_ASSERT(context);
1602 WINPR_ASSERT(context->rdp);
1603 return context->rdp->GetCommonAccessToken;
FREERDP_API BOOL freerdp_settings_set_uint32(rdpSettings *settings, FreeRDP_Settings_Keys_UInt32 id, UINT32 val)
Sets a UINT32 settings value.
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 const char * freerdp_settings_get_string(const rdpSettings *settings, FreeRDP_Settings_Keys_String id)
Returns a immutable string settings value.
FREERDP_API void freerdp_settings_free(rdpSettings *settings)
Free a settings struct with all data in it.
WINPR_ATTR_NODISCARD FREERDP_API rdpSettings * freerdp_settings_new(DWORD flags)
creates a new setting struct
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_get_bool(const rdpSettings *settings, FreeRDP_Settings_Keys_Bool id)
Returns a boolean settings value.