21#include <freerdp/config.h>
26#include <winpr/image.h>
27#include <winpr/stream.h>
28#include <winpr/clipboard.h>
30#include <freerdp/log.h>
31#include <freerdp/client/cliprdr.h>
32#include <freerdp/channels/channels.h>
33#include <freerdp/channels/cliprdr.h>
35#include <freerdp/client/client_cliprdr_file.h>
37#include "wlf_cliprdr.h"
39#define TAG CLIENT_TAG("wayland.cliprdr")
41#define mime_text_plain "text/plain"
43static const char mime_text_utf8[] = mime_text_plain
";charset=utf-8";
46static const char* mime_text[] = { mime_text_plain, mime_text_utf8,
"UTF8_STRING",
47 "COMPOUND_TEXT",
"TEXT",
"STRING" };
49static const char mime_png[] =
"image/png";
50static const char mime_webp[] =
"image/webp";
51static const char mime_jpg[] =
"image/jpeg";
52static const char mime_tiff[] =
"image/tiff";
53static const char mime_uri_list[] =
"text/uri-list";
54static const char mime_html[] =
"text/html";
56#define BMP_MIME_LIST "image/bmp", "image/x-bmp", "image/x-MS-bmp", "image/x-win-bitmap"
57static const char* mime_bitmap[] = { BMP_MIME_LIST };
58static const char* mime_image[] = { mime_png, mime_webp, mime_jpg, mime_tiff, BMP_MIME_LIST };
60static const char mime_gnome_copied_files[] =
"x-special/gnome-copied-files";
61static const char mime_mate_copied_files[] =
"x-special/mate-copied-files";
63static const char type_FileGroupDescriptorW[] =
"FileGroupDescriptorW";
64static const char type_HtmlFormat[] =
"HTML Format";
69 UINT32 responseFormat;
75 const FILE* responseFile;
76 UINT32 responseFormat;
77 const char* responseMime;
83 rdpChannels* channels;
84 CliprdrClientContext* context;
90 size_t numClientFormats;
93 size_t numServerFormats;
99 CliprdrFileContext* file;
101 wQueue* request_queue;
104static void wlf_request_free(
void* rq)
106 wlf_request* request = rq;
109 free(request->responseMime);
110 if (request->responseFile)
111 (void)fclose(request->responseFile);
116static wlf_request* wlf_request_new(
void)
118 return calloc(1,
sizeof(wlf_request));
121static void* wlf_request_clone(
const void* oth)
123 const wlf_request* other = (
const wlf_request*)oth;
124 wlf_request* copy = wlf_request_new();
128 if (other->responseMime)
130 copy->responseMime = _strdup(other->responseMime);
131 if (!copy->responseMime)
136 wlf_request_free(copy);
140static BOOL wlf_mime_is_file(
const char* mime)
142 if (strncmp(mime_uri_list, mime,
sizeof(mime_uri_list)) == 0)
144 if (strncmp(mime_gnome_copied_files, mime,
sizeof(mime_gnome_copied_files)) == 0)
146 if (strncmp(mime_mate_copied_files, mime,
sizeof(mime_mate_copied_files)) == 0)
151static BOOL wlf_mime_is_text(
const char* mime)
153 for (
size_t x = 0; x < ARRAYSIZE(mime_text); x++)
155 if (strcmp(mime, mime_text[x]) == 0)
162static BOOL wlf_mime_is_image(
const char* mime)
164 for (
size_t x = 0; x < ARRAYSIZE(mime_image); x++)
166 if (strcmp(mime, mime_image[x]) == 0)
173static BOOL wlf_mime_is_html(
const char* mime)
175 return strcmp(mime, mime_html) == 0;
178static void wlf_cliprdr_free_server_formats(wfClipboard* clipboard)
180 if (clipboard && clipboard->serverFormats)
182 for (
size_t j = 0; j < clipboard->numServerFormats; j++)
185 free(format->formatName);
188 free(clipboard->serverFormats);
189 clipboard->serverFormats =
nullptr;
190 clipboard->numServerFormats = 0;
194 UwacClipboardOfferDestroy(clipboard->seat);
197static void wlf_cliprdr_free_client_formats(wfClipboard* clipboard)
199 if (clipboard && clipboard->numClientFormats)
201 for (
size_t j = 0; j < clipboard->numClientFormats; j++)
204 free(format->formatName);
207 free(clipboard->clientFormats);
208 clipboard->clientFormats =
nullptr;
209 clipboard->numClientFormats = 0;
213 UwacClipboardOfferDestroy(clipboard->seat);
221static UINT wlf_cliprdr_send_client_format_list(wfClipboard* clipboard)
223 WINPR_ASSERT(clipboard);
226 .numFormats = (UINT32)clipboard->numClientFormats,
227 .formats = clipboard->clientFormats,
228 .common.msgType = CB_FORMAT_LIST };
230 if (!cliprdr_file_context_clear(clipboard->file))
231 return ERROR_INTERNAL_ERROR;
233 WLog_VRB(TAG,
"-------------- client format list [%" PRIu32
"] ------------------",
234 formatList.numFormats);
235 for (UINT32 x = 0; x < formatList.numFormats; x++)
238 WLog_VRB(TAG,
"client announces %" PRIu32
" [%s][%s]", format->formatId,
239 ClipboardGetFormatIdString(format->formatId), format->formatName);
241 WINPR_ASSERT(clipboard->context);
242 WINPR_ASSERT(clipboard->context->ClientFormatList);
243 return clipboard->context->ClientFormatList(clipboard->context, &formatList);
246static void wfl_cliprdr_add_client_format_id(wfClipboard* clipboard, UINT32 formatId)
249 const char* name = ClipboardGetFormatName(clipboard->system, formatId);
251 for (
size_t x = 0; x < clipboard->numClientFormats; x++)
253 format = &clipboard->clientFormats[x];
255 if (format->formatId == formatId)
259 format = realloc(clipboard->clientFormats,
265 clipboard->clientFormats = format;
266 format = &clipboard->clientFormats[clipboard->numClientFormats++];
267 format->formatId = formatId;
268 format->formatName =
nullptr;
270 if (name && (formatId >= CF_MAX))
271 format->formatName = _strdup(name);
274static BOOL wlf_cliprdr_add_client_format(wfClipboard* clipboard,
const char* mime)
277 ClipboardLock(clipboard->system);
278 if (wlf_mime_is_html(mime))
280 UINT32 formatId = ClipboardGetFormatId(clipboard->system, type_HtmlFormat);
281 wfl_cliprdr_add_client_format_id(clipboard, formatId);
283 else if (wlf_mime_is_text(mime))
285 wfl_cliprdr_add_client_format_id(clipboard, CF_TEXT);
286 wfl_cliprdr_add_client_format_id(clipboard, CF_OEMTEXT);
287 wfl_cliprdr_add_client_format_id(clipboard, CF_UNICODETEXT);
289 else if (wlf_mime_is_image(mime))
291 for (
size_t x = 0; x < ARRAYSIZE(mime_image); x++)
293 const char* mime_bmp = mime_image[x];
294 UINT32 formatId = ClipboardGetFormatId(clipboard->system, mime_bmp);
296 wfl_cliprdr_add_client_format_id(clipboard, formatId);
298 wfl_cliprdr_add_client_format_id(clipboard, CF_DIB);
299 wfl_cliprdr_add_client_format_id(clipboard, CF_TIFF);
301 else if (wlf_mime_is_file(mime))
303 const UINT32 fileFormatId =
304 ClipboardGetFormatId(clipboard->system, type_FileGroupDescriptorW);
305 wfl_cliprdr_add_client_format_id(clipboard, fileFormatId);
308 ClipboardUnlock(clipboard->system);
309 return (wlf_cliprdr_send_client_format_list(clipboard) == CHANNEL_RC_OK);
317static UINT wlf_cliprdr_send_data_request(wfClipboard* clipboard,
const wlf_const_request* rq)
323 if (!Queue_Enqueue(clipboard->request_queue, rq))
324 return ERROR_INTERNAL_ERROR;
326 WINPR_ASSERT(clipboard);
327 WINPR_ASSERT(clipboard->context);
328 WINPR_ASSERT(clipboard->context->ClientFormatDataRequest);
329 return clipboard->context->ClientFormatDataRequest(clipboard->context, &request);
337static UINT wlf_cliprdr_send_data_response(wfClipboard* clipboard,
const BYTE* data,
size_t size)
341 if (size > UINT32_MAX)
342 return ERROR_INVALID_PARAMETER;
344 response.common.msgFlags = (data) ? CB_RESPONSE_OK : CB_RESPONSE_FAIL;
345 response.common.dataLen = (UINT32)size;
346 response.requestedFormatData = data;
348 WINPR_ASSERT(clipboard);
349 WINPR_ASSERT(clipboard->context);
350 WINPR_ASSERT(clipboard->context->ClientFormatDataResponse);
351 return clipboard->context->ClientFormatDataResponse(clipboard->context, &response);
354BOOL wlf_cliprdr_handle_event(wfClipboard* clipboard,
const UwacClipboardEvent* event)
356 if (!clipboard || !event)
359 if (!clipboard->context)
364 case UWAC_EVENT_CLIPBOARD_AVAILABLE:
365 clipboard->seat =
event->seat;
368 case UWAC_EVENT_CLIPBOARD_OFFER:
369 WLog_Print(clipboard->log, WLOG_DEBUG,
"client announces mime %s", event->mime);
370 return wlf_cliprdr_add_client_format(clipboard, event->mime);
372 case UWAC_EVENT_CLIPBOARD_SELECT:
373 WLog_Print(clipboard->log, WLOG_DEBUG,
"client announces new data");
374 wlf_cliprdr_free_client_formats(clipboard);
387static UINT wlf_cliprdr_send_client_capabilities(wfClipboard* clipboard)
389 WINPR_ASSERT(clipboard);
392 .capabilitySetType = CB_CAPSTYPE_GENERAL,
393 .capabilitySetLength = 12,
394 .version = CB_CAPS_VERSION_2,
396 CB_USE_LONG_FORMAT_NAMES | cliprdr_file_context_current_flags(clipboard->file)
402 WINPR_ASSERT(clipboard);
403 WINPR_ASSERT(clipboard->context);
404 WINPR_ASSERT(clipboard->context->ClientCapabilities);
405 return clipboard->context->ClientCapabilities(clipboard->context, &capabilities);
413static UINT wlf_cliprdr_send_client_format_list_response(wfClipboard* clipboard, BOOL status)
416 .common.msgType = CB_FORMAT_LIST_RESPONSE,
417 .common.msgFlags = status ? CB_RESPONSE_OK : CB_RESPONSE_FAIL,
420 WINPR_ASSERT(clipboard);
421 WINPR_ASSERT(clipboard->context);
422 WINPR_ASSERT(clipboard->context->ClientFormatListResponse);
423 return clipboard->context->ClientFormatListResponse(clipboard->context, &formatListResponse);
431static UINT wlf_cliprdr_monitor_ready(CliprdrClientContext* context,
436 WINPR_UNUSED(monitorReady);
437 WINPR_ASSERT(context);
438 WINPR_ASSERT(monitorReady);
440 wfClipboard* clipboard = cliprdr_file_context_get_context(context->custom);
441 WINPR_ASSERT(clipboard);
443 if ((ret = wlf_cliprdr_send_client_capabilities(clipboard)) != CHANNEL_RC_OK)
446 if ((ret = wlf_cliprdr_send_client_format_list(clipboard)) != CHANNEL_RC_OK)
449 clipboard->sync = TRUE;
450 return CHANNEL_RC_OK;
458static UINT wlf_cliprdr_server_capabilities(CliprdrClientContext* context,
461 WINPR_ASSERT(context);
462 WINPR_ASSERT(capabilities);
464 const BYTE* capsPtr = (
const BYTE*)capabilities->capabilitySets;
465 WINPR_ASSERT(capsPtr);
467 wfClipboard* clipboard = cliprdr_file_context_get_context(context->custom);
468 WINPR_ASSERT(clipboard);
470 if (!cliprdr_file_context_remote_set_flags(clipboard->file, 0))
471 return ERROR_INTERNAL_ERROR;
473 for (UINT32 i = 0; i < capabilities->cCapabilitiesSets; i++)
478 if (caps->capabilitySetType == CB_CAPSTYPE_GENERAL)
483 if (!cliprdr_file_context_remote_set_flags(clipboard->file, generalCaps->generalFlags))
484 return ERROR_INTERNAL_ERROR;
487 capsPtr += caps->capabilitySetLength;
490 return CHANNEL_RC_OK;
493static UINT32 wlf_get_server_format_id(
const wfClipboard* clipboard,
const char* name)
495 WINPR_ASSERT(clipboard);
498 for (UINT32 x = 0; x < clipboard->numServerFormats; x++)
501 if (!format->formatName)
503 if (strcmp(name, format->formatName) == 0)
504 return format->formatId;
509static const char* wlf_get_server_format_name(
const wfClipboard* clipboard, UINT32 formatId)
511 WINPR_ASSERT(clipboard);
513 for (UINT32 x = 0; x < clipboard->numServerFormats; x++)
516 if (format->formatId == formatId)
517 return format->formatName;
522static void wlf_cliprdr_transfer_data(UwacSeat* seat,
void* context,
const char* mime,
int fd)
524 wfClipboard* clipboard = (wfClipboard*)context;
527 EnterCriticalSection(&clipboard->lock);
529 wlf_const_request request = WINPR_C_ARRAY_INIT;
530 if (wlf_mime_is_html(mime))
532 request.responseMime = mime_html;
533 request.responseFormat = wlf_get_server_format_id(clipboard, type_HtmlFormat);
535 else if (wlf_mime_is_file(mime))
537 request.responseMime = mime;
538 request.responseFormat = wlf_get_server_format_id(clipboard, type_FileGroupDescriptorW);
540 else if (wlf_mime_is_text(mime))
542 request.responseMime = mime_text_plain;
543 request.responseFormat = CF_UNICODETEXT;
545 else if (wlf_mime_is_image(mime))
547 request.responseMime = mime;
548 if (strcmp(mime, mime_tiff) == 0)
549 request.responseFormat = CF_TIFF;
551 request.responseFormat = CF_DIB;
554 if (request.responseMime !=
nullptr)
556 request.responseFile = fdopen(fd,
"w");
558 if (request.responseFile)
559 wlf_cliprdr_send_data_request(clipboard, &request);
561 WLog_Print(clipboard->log, WLOG_ERROR,
562 "failed to open clipboard file descriptor for MIME %s",
563 request.responseMime);
566 LeaveCriticalSection(&clipboard->lock);
569static void wlf_cliprdr_cancel_data(UwacSeat* seat,
void* context)
571 wfClipboard* clipboard = (wfClipboard*)context;
574 WINPR_ASSERT(clipboard);
575 cliprdr_file_context_clear(clipboard->file);
586static UINT wlf_cliprdr_server_format_list(CliprdrClientContext* context,
594 if (!context || !context->custom)
595 return ERROR_INVALID_PARAMETER;
597 wfClipboard* clipboard = cliprdr_file_context_get_context(context->custom);
598 WINPR_ASSERT(clipboard);
600 wlf_cliprdr_free_server_formats(clipboard);
601 if (!cliprdr_file_context_clear(clipboard->file))
602 return ERROR_INTERNAL_ERROR;
604 if (!(clipboard->serverFormats =
607 WLog_Print(clipboard->log, WLOG_ERROR,
608 "failed to allocate %" PRIuz
" CLIPRDR_FORMAT structs",
609 clipboard->numServerFormats);
610 return CHANNEL_RC_NO_MEMORY;
613 clipboard->numServerFormats = formatList->numFormats;
615 if (!clipboard->seat)
617 WLog_Print(clipboard->log, WLOG_ERROR,
618 "clipboard->seat=nullptr, check your client implementation");
619 return ERROR_INTERNAL_ERROR;
622 for (UINT32 i = 0; i < formatList->numFormats; i++)
626 srvFormat->formatId = format->formatId;
628 if (format->formatName)
630 srvFormat->formatName = _strdup(format->formatName);
632 if (!srvFormat->formatName)
634 wlf_cliprdr_free_server_formats(clipboard);
635 return CHANNEL_RC_NO_MEMORY;
639 if (format->formatName)
641 if (strcmp(format->formatName, type_HtmlFormat) == 0)
646 else if (strcmp(format->formatName, type_FileGroupDescriptorW) == 0)
654 switch (format->formatId)
674 UwacClipboardOfferCreate(clipboard->seat, mime_html);
677 if (file && cliprdr_file_context_has_local_support(clipboard->file))
679 UwacClipboardOfferCreate(clipboard->seat, mime_uri_list);
680 UwacClipboardOfferCreate(clipboard->seat, mime_gnome_copied_files);
681 UwacClipboardOfferCreate(clipboard->seat, mime_mate_copied_files);
686 for (
size_t x = 0; x < ARRAYSIZE(mime_text); x++)
687 UwacClipboardOfferCreate(clipboard->seat, mime_text[x]);
692 for (
size_t x = 0; x < ARRAYSIZE(mime_image); x++)
693 UwacClipboardOfferCreate(clipboard->seat, mime_image[x]);
696 UwacClipboardOfferAnnounce(clipboard->seat, clipboard, wlf_cliprdr_transfer_data,
697 wlf_cliprdr_cancel_data);
698 return wlf_cliprdr_send_client_format_list_response(clipboard, TRUE);
707wlf_cliprdr_server_format_list_response(WINPR_ATTR_UNUSED CliprdrClientContext* context,
710 WINPR_ASSERT(context);
711 WINPR_ASSERT(formatListResponse);
713 if (formatListResponse->common.msgFlags & CB_RESPONSE_FAIL)
714 WLog_WARN(TAG,
"format list update failed");
715 return CHANNEL_RC_OK;
724wlf_cliprdr_server_format_data_request(CliprdrClientContext* context,
727 UINT rc = CHANNEL_RC_OK;
728 char* data =
nullptr;
730 const char* mime =
nullptr;
732 UINT32 localFormatId = 0;
733 wfClipboard* clipboard =
nullptr;
736 BYTE* ddata =
nullptr;
738 WINPR_ASSERT(context);
739 WINPR_ASSERT(formatDataRequest);
741 localFormatId = formatId = formatDataRequest->requestedFormatId;
742 clipboard = cliprdr_file_context_get_context(context->custom);
743 WINPR_ASSERT(clipboard);
745 ClipboardLock(clipboard->system);
746 const UINT32 fileFormatId = ClipboardGetFormatId(clipboard->system, type_FileGroupDescriptorW);
747 const UINT32 htmlFormatId = ClipboardGetFormatId(clipboard->system, type_HtmlFormat);
754 localFormatId = ClipboardGetFormatId(clipboard->system, mime_text_plain);
755 mime = mime_text_utf8;
760 mime = mime_bitmap[0];
768 if (formatId == fileFormatId)
770 localFormatId = ClipboardGetFormatId(clipboard->system, mime_uri_list);
771 mime = mime_uri_list;
773 else if (formatId == htmlFormatId)
775 localFormatId = ClipboardGetFormatId(clipboard->system, mime_html);
783 data = UwacClipboardDataGet(clipboard->seat, mime, &size);
785 if (!data || (size > UINT32_MAX))
788 if (fileFormatId == formatId)
790 if (!cliprdr_file_context_update_client_data(clipboard->file, data, size))
795 const BOOL res = ClipboardSetData(clipboard->system, localFormatId, data, (UINT32)size);
801 data = ClipboardGetData(clipboard->system, formatId, &len);
806 if (fileFormatId == formatId)
808 const UINT32 flags = cliprdr_file_context_remote_get_flags(clipboard->file);
809 const UINT32 error = cliprdr_serialize_file_list_ex(
817 ClipboardUnlock(clipboard->system);
818 rc = wlf_cliprdr_send_data_response(clipboard, ddata, dsize);
829wlf_cliprdr_server_format_data_response(CliprdrClientContext* context,
832 UINT rc = ERROR_INTERNAL_ERROR;
834 WINPR_ASSERT(context);
835 WINPR_ASSERT(formatDataResponse);
837 const UINT32 size = formatDataResponse->common.dataLen;
838 const BYTE* data = formatDataResponse->requestedFormatData;
840 wfClipboard* clipboard = cliprdr_file_context_get_context(context->custom);
841 WINPR_ASSERT(clipboard);
843 wlf_request* request = Queue_Dequeue(clipboard->request_queue);
848 if (formatDataResponse->common.msgFlags & CB_RESPONSE_FAIL)
850 WLog_WARN(TAG,
"clipboard data request for format %" PRIu32
" [%s], mime %s failed",
851 request->responseFormat, ClipboardGetFormatIdString(request->responseFormat),
852 request->responseMime);
855 rc = ERROR_INTERNAL_ERROR;
857 ClipboardLock(clipboard->system);
858 EnterCriticalSection(&clipboard->lock);
860 BYTE* cdata =
nullptr;
861 UINT32 srcFormatId = 0;
862 UINT32 dstFormatId = 0;
863 switch (request->responseFormat)
868 srcFormatId = request->responseFormat;
869 dstFormatId = ClipboardGetFormatId(clipboard->system, request->responseMime);
874 srcFormatId = request->responseFormat;
875 dstFormatId = ClipboardGetFormatId(clipboard->system, request->responseMime);
880 const char* name = wlf_get_server_format_name(clipboard, request->responseFormat);
883 if (strcmp(type_FileGroupDescriptorW, name) == 0)
886 ClipboardGetFormatId(clipboard->system, type_FileGroupDescriptorW);
888 ClipboardGetFormatId(clipboard->system, request->responseMime);
890 if (!cliprdr_file_context_update_server_data(clipboard->file,
891 clipboard->system, data, size))
894 else if (strcmp(type_HtmlFormat, name) == 0)
896 srcFormatId = ClipboardGetFormatId(clipboard->system, type_HtmlFormat);
898 ClipboardGetFormatId(clipboard->system, request->responseMime);
908 const BOOL sres = ClipboardSetData(clipboard->system, srcFormatId, data, size);
910 cdata = ClipboardGetData(clipboard->system, dstFormatId, &len);
916 if (request->responseFile)
918 const size_t res = fwrite(cdata, 1, len, request->responseFile);
929 ClipboardUnlock(clipboard->system);
930 LeaveCriticalSection(&clipboard->lock);
932 wlf_request_free(request);
936wfClipboard* wlf_clipboard_new(
wlfContext* wfc)
938 rdpChannels* channels =
nullptr;
939 wfClipboard* clipboard =
nullptr;
943 clipboard = (wfClipboard*)calloc(1,
sizeof(wfClipboard));
948 InitializeCriticalSection(&clipboard->lock);
949 clipboard->wfc = wfc;
950 channels = wfc->common.context.channels;
951 clipboard->log = WLog_Get(TAG);
952 clipboard->channels = channels;
953 clipboard->system = ClipboardCreate();
954 if (!clipboard->system)
957 clipboard->file = cliprdr_file_context_new(clipboard);
958 if (!clipboard->file)
961 if (!cliprdr_file_context_set_locally_available(clipboard->file, TRUE))
964 clipboard->request_queue = Queue_New(TRUE, -1, -1);
965 if (!clipboard->request_queue)
969 wObject* obj = Queue_Object(clipboard->request_queue);
978 wlf_clipboard_free(clipboard);
982void wlf_clipboard_free(wfClipboard* clipboard)
987 cliprdr_file_context_free(clipboard->file);
989 wlf_cliprdr_free_server_formats(clipboard);
990 wlf_cliprdr_free_client_formats(clipboard);
991 ClipboardDestroy(clipboard->system);
993 EnterCriticalSection(&clipboard->lock);
995 Queue_Free(clipboard->request_queue);
996 LeaveCriticalSection(&clipboard->lock);
997 DeleteCriticalSection(&clipboard->lock);
1001BOOL wlf_cliprdr_init(wfClipboard* clipboard, CliprdrClientContext* cliprdr)
1003 WINPR_ASSERT(clipboard);
1004 WINPR_ASSERT(cliprdr);
1006 clipboard->context = cliprdr;
1007 cliprdr->MonitorReady = wlf_cliprdr_monitor_ready;
1008 cliprdr->ServerCapabilities = wlf_cliprdr_server_capabilities;
1009 cliprdr->ServerFormatList = wlf_cliprdr_server_format_list;
1010 cliprdr->ServerFormatListResponse = wlf_cliprdr_server_format_list_response;
1011 cliprdr->ServerFormatDataRequest = wlf_cliprdr_server_format_data_request;
1012 cliprdr->ServerFormatDataResponse = wlf_cliprdr_server_format_data_response;
1014 return cliprdr_file_context_init(clipboard->file, cliprdr);
1017BOOL wlf_cliprdr_uninit(wfClipboard* clipboard, CliprdrClientContext* cliprdr)
1019 WINPR_ASSERT(clipboard);
1020 if (!cliprdr_file_context_uninit(clipboard->file, cliprdr))
1024 cliprdr->custom =
nullptr;
This struct contains function pointer to initialize/free objects.
OBJECT_FREE_FN fnObjectFree
WINPR_ATTR_NODISCARD OBJECT_NEW_FN fnObjectNew