Updated (prepare|unprepare)header functions (wave, midi) to allow
[wine/multimedia.git] / misc / ddeml.c
blobd0a2abf66aa89581e72f49d56a8fc4337041fc2a
1 /*
2 * DDEML library
4 * Copyright 1997 Alexandre Julliard
5 * Copyright 1997 Len White
6 * Copyright 1999 Keith Matthews
7 */
9 /* Only empty stubs for now */
11 #include <stdlib.h>
12 #include <string.h>
13 #include "winbase.h"
14 #include "winuser.h"
15 #include "ddeml.h"
16 #include "winerror.h"
17 #include "heap.h"
18 #include "shm_semaph.h"
19 #include "debug.h"
20 #include "winnt.h"
22 /* Has defined in atom.c file.
24 #define MAX_ATOM_LEN 255
26 /* Maximum buffer size ( including the '\0' ).
28 #define MAX_BUFFER_LEN (MAX_ATOM_LEN + 1)
30 /* typedef struct {
31 DWORD nLength;
32 LPVOID lpSecurityDescriptor;
33 BOOL bInheritHandle;
34 } SECURITY_ATTRIBUTES; */
36 /* This is a simple list to keep track of the strings created
37 * by DdeCreateStringHandle. The list is used to free
38 * the strings whenever DdeUninitialize is called.
39 * This mechanism is not complete and does not handle multiple instances.
40 * Most of the DDE API use a DWORD parameter indicating which instance
41 * of a given program is calling them. The API are supposed to
42 * associate the data to the instance that created it.
44 typedef struct tagHSZNode HSZNode;
45 struct tagHSZNode
47 HSZNode* next;
48 HSZ hsz;
52 typedef struct DDE_HANDLE_ENTRY {
53 BOOL16 Monitor; /* have these two as full Booleans cos they'll be tested frequently */
54 BOOL16 Client_only; /* bit wasteful of space but it will be faster */
55 BOOL16 Unicode; /* Flag to indicate Win32 API used to initialise */
56 BOOL16 Win16; /* flag to indicate Win16 API used to initialize */
57 DWORD Instance_id; /* needed to track monitor usage */
58 struct DDE_HANDLE_ENTRY *Next_Entry;
59 HSZNode *Node_list;
60 PFNCALLBACK CallBack;
61 DWORD CBF_Flags;
62 DWORD Monitor_flags;
63 UINT Txn_count; /* count transactions open to simplify closure */
64 DWORD Last_Error;
65 } DDE_HANDLE_ENTRY;
67 static DDE_HANDLE_ENTRY *DDE_Handle_Table_Base = NULL;
68 static DWORD DDE_Max_Assigned_Instance = 0; /* OK for present, may have to worry about wrap-around later */
69 static const char inst_string[]= "DDEMaxInstance";
70 static LPCWSTR DDEInstanceAccess = (LPCWSTR)&inst_string;
71 static const char handle_string[] = "DDEHandleAccess";
72 static LPCWSTR DDEHandleAccess = (LPCWSTR)&handle_string;
73 static HANDLE inst_count_mutex = 0;
74 static HANDLE handle_mutex = 0;
75 DDE_HANDLE_ENTRY *this_instance;
76 SECURITY_ATTRIBUTES *s_att= NULL;
77 DWORD err_no = 0;
78 DDE_HANDLE_ENTRY *reference_inst;
80 #define TRUE 1
81 #define FALSE 0
87 /******************************************************************************
88 * RemoveHSZNodes (INTERNAL)
90 * Remove a node from the list of HSZ nodes.
92 ******************************************************************************
94 * Change History
96 * Vn Date Author Comment
98 * 1.0 Dec 1998 Corel/Macadamian Initial version
99 * 1.1 Mar 1999 Keith Matthews Added multiple instance handling
102 static void RemoveHSZNode( HSZ hsz )
104 HSZNode* pPrev = NULL;
105 HSZNode* pCurrent = NULL;
107 /* Set the current node at the start of the list.
109 pCurrent = reference_inst->Node_list;
110 /* While we have more nodes.
112 while( pCurrent != NULL )
114 /* If we found the node we were looking for.
116 if( pCurrent->hsz == hsz )
118 /* Remove the node.
120 /* If the first node in the list is to to be removed.
121 * Set the global list pointer to the next node.
123 if( pCurrent == reference_inst->Node_list )
125 reference_inst->Node_list = pCurrent->next;
127 /* Just fix the pointers has to skip the current
128 * node so we can delete it.
130 else
132 pPrev->next = pCurrent->next;
134 /* Destroy this node.
136 free( pCurrent );
137 break;
139 /* Save the previous node pointer.
141 pPrev = pCurrent;
142 /* Move on to the next node.
144 pCurrent = pCurrent->next;
148 /******************************************************************************
149 * FreeAndRemoveHSZNodes (INTERNAL)
151 * Frees up all the strings still allocated in the list and
152 * remove all the nodes from the list of HSZ nodes.
154 ******************************************************************************
156 * Change History
158 * Vn Date Author Comment
160 * 1.0 Dec 1998 Corel/Macadamian Initial version
161 * 1.1 Mar 1999 Keith Matthews Added multiple instance handling
164 static void FreeAndRemoveHSZNodes( DWORD idInst )
166 /* Free any strings created in this instance.
168 while( reference_inst->Node_list != NULL )
170 DdeFreeStringHandle( idInst, reference_inst->Node_list->hsz );
174 /******************************************************************************
175 * InsertHSZNode (INTERNAL)
177 * Insert a node to the head of the list.
179 ******************************************************************************
181 * Change History
183 * Vn Date Author Comment
185 * 1.0 Dec 1998 Corel/Macadamian Initial version
186 * 1.1 Mar 1999 Keith Matthews Added instance handling
189 static void InsertHSZNode( HSZ hsz )
191 if( hsz != 0 )
193 HSZNode* pNew = NULL;
194 /* Create a new node for this HSZ.
196 pNew = (HSZNode*) malloc( sizeof( HSZNode ) );
197 if( pNew != NULL )
199 /* Set the handle value.
201 pNew->hsz = hsz;
202 /* Attach the node to the head of the list. i.e most recently added is first
204 pNew->next = reference_inst->Node_list;
205 /* The new node is now at the head of the list
206 * so set the global list pointer to it.
208 reference_inst->Node_list = pNew;
209 TRACE(ddeml,"HSZ node list entry added\n");
214 /*****************************************************************************
215 * Find_Instance_Entry
217 * generic routine to return a pointer to the relevant DDE_HANDLE_ENTRY
218 * for an instance Id, or NULL if the entry does not exist
220 * ASSUMES the mutex protecting the handle entry list is reserved before calling
222 ******************************************************************************
224 * Change History
226 * Vn Date Author Comment
228 * 1.0 March 1999 Keith Matthews 1st implementation
230 DDE_HANDLE_ENTRY *Find_Instance_Entry (DWORD InstId)
232 reference_inst = DDE_Handle_Table_Base;
233 while ( reference_inst != NULL )
235 if ( reference_inst->Instance_id == InstId )
237 TRACE(ddeml,"Instance entry found\n");
238 return reference_inst;
240 reference_inst = reference_inst->Next_Entry;
242 TRACE(ddeml,"Instance entry missing\n");
243 return NULL;
246 /******************************************************************************
247 * Release_reserved_mutex
249 * generic routine to release a reserved mutex
252 ******************************************************************************
254 * Change History
256 * Vn Date Author Comment
258 * 1.0 Jan 1999 Keith Matthews Initial version
259 * 1.1 Mar 1999 Keith Matthews Corrected Heap handling. Corrected re-initialisation handling
262 DWORD Release_reserved_mutex (HANDLE mutex, LPTSTR mutex_name, BOOL release_handle_m, BOOL release_this_i )
264 ReleaseMutex(mutex);
265 if ( (err_no=GetLastError()) != 0 )
267 ERR(ddeml,"ReleaseMutex failed - %s mutex %li\n",mutex_name,err_no);
268 HeapFree(SystemHeap, 0, this_instance);
269 if ( release_handle_m )
271 ReleaseMutex(handle_mutex);
273 return DMLERR_SYS_ERROR;
275 if ( release_this_i )
277 HeapFree(SystemHeap, 0, this_instance);
279 return DMLERR_NO_ERROR;
282 /******************************************************************************
283 * IncrementInstanceId
285 * generic routine to increment the max instance Id and allocate a new application instance
287 ******************************************************************************
289 * Change History
291 * Vn Date Author Comment
293 * 1.0 Jan 1999 Keith Matthews Initial version
296 DWORD IncrementInstanceId()
298 SECURITY_ATTRIBUTES s_attrib;
299 /* Need to set up Mutex in case it is not already present */
300 /* increment handle count & get value */
301 if ( !inst_count_mutex )
303 s_attrib.bInheritHandle = TRUE;
304 s_attrib.lpSecurityDescriptor = NULL;
305 s_attrib.nLength = sizeof(s_attrib);
306 inst_count_mutex = CreateMutexW(&s_attrib,1,DDEInstanceAccess); /* 1st time through */
307 } else {
308 WaitForSingleObject(inst_count_mutex,1000); /* subsequent calls */
309 /* FIXME - needs refinement with popup for timeout, also is timeout interval OK */
311 if ( (err_no=GetLastError()) != 0 )
313 ERR(ddeml,"CreateMutex failed - inst_count %li\n",err_no);
314 err_no=Release_reserved_mutex (handle_mutex,"handle_mutex",0,1);
315 return DMLERR_SYS_ERROR;
317 DDE_Max_Assigned_Instance++;
318 this_instance->Instance_id = DDE_Max_Assigned_Instance;
319 TRACE(ddeml,"New instance id %ld allocated\n",DDE_Max_Assigned_Instance);
320 if (Release_reserved_mutex(inst_count_mutex,"instance_count",1,0)) return DMLERR_SYS_ERROR;
321 return DMLERR_NO_ERROR;
324 /******************************************************************************
325 * DdeInitialize16 (DDEML.2)
327 UINT16 WINAPI DdeInitialize16( LPDWORD pidInst, PFNCALLBACK16 pfnCallback,
328 DWORD afCmd, DWORD ulRes)
330 TRACE(ddeml,"DdeInitialize16 called - calling DdeInitializeA\n");
331 return (UINT16)DdeInitializeA(pidInst,(PFNCALLBACK)pfnCallback,
332 afCmd, ulRes);
336 /******************************************************************************
337 * DdeInitializeA (USER32.106)
339 UINT WINAPI DdeInitializeA( LPDWORD pidInst, PFNCALLBACK pfnCallback,
340 DWORD afCmd, DWORD ulRes )
342 TRACE(ddeml,"DdeInitializeA called - calling DdeInitializeW\n");
343 return DdeInitializeW(pidInst,pfnCallback,afCmd,ulRes);
347 /******************************************************************************
348 * DdeInitializeW [USER32.107]
349 * Registers an application with the DDEML
351 * PARAMS
352 * pidInst [I] Pointer to instance identifier
353 * pfnCallback [I] Pointer to callback function
354 * afCmd [I] Set of command and filter flags
355 * ulRes [I] Reserved
357 * RETURNS
358 * Success: DMLERR_NO_ERROR
359 * Failure: DMLERR_DLL_USAGE, DMLERR_INVALIDPARAMETER, DMLERR_SYS_ERROR
361 ******************************************************************************
363 * Change History
365 * Vn Date Author Comment
367 * 1.0 Pre 1998 Alexandre/Len Initial Stub
368 * 1.1 Jan 1999 Keith Matthews Initial (near-)complete version
369 * 1.2 Mar 1999 Keith Matthews Corrected Heap handling, CreateMutex failure handling
372 UINT WINAPI DdeInitializeW( LPDWORD pidInst, PFNCALLBACK pfnCallback,
373 DWORD afCmd, DWORD ulRes )
376 /* probably not really capable of handling mutliple processes, but should handle
377 * multiple instances within one process */
379 SECURITY_ATTRIBUTES s_attrib;
380 s_att = &s_attrib;
382 if( ulRes )
384 ERR(ddeml, "Reserved value not zero? What does this mean?\n");
385 FIXME(ddeml, "(%p,%p,0x%lx,%ld): stub\n", pidInst, pfnCallback,
386 afCmd,ulRes);
387 /* trap this and no more until we know more */
388 return DMLERR_NO_ERROR;
390 if (!pfnCallback )
392 /* this one may be wrong - MS dll seems to accept the condition,
393 leave this until we find out more !! */
396 /* can't set up the instance with nothing to act as a callback */
397 TRACE(ddeml,"No callback provided\n");
398 return DMLERR_INVALIDPARAMETER; /* might be DMLERR_DLL_USAGE */
401 /* grab enough heap for one control struct - not really necessary for re-initialise
402 * but allows us to use same validation routines */
403 this_instance= (DDE_HANDLE_ENTRY*)HeapAlloc( SystemHeap, 0, sizeof(DDE_HANDLE_ENTRY) );
404 if ( this_instance == NULL )
406 /* catastrophe !! warn user & abort */
407 ERR (ddeml, "Instance create failed - out of memory\n");
408 return DMLERR_SYS_ERROR;
410 this_instance->Next_Entry = NULL;
411 this_instance->Monitor=(afCmd|APPCLASS_MONITOR);
413 /* messy bit, spec implies that 'Client Only' can be set in 2 different ways, catch 1 here */
415 this_instance->Client_only=afCmd&APPCMD_CLIENTONLY;
416 this_instance->Instance_id = *pidInst; /* May need to add calling proc Id */
417 this_instance->CallBack=*pfnCallback;
418 this_instance->Txn_count=0;
419 this_instance->Unicode = TRUE;
420 this_instance->Win16 = FALSE;
421 this_instance->Node_list = NULL; /* node will be added later */
422 this_instance->Monitor_flags = afCmd & MF_MASK;
424 /* isolate CBF flags in one go, expect this will go the way of all attempts to be clever !! */
426 this_instance->CBF_Flags=afCmd^((afCmd&MF_MASK)|((afCmd&APPCMD_MASK)|(afCmd&APPCLASS_MASK)));
428 if ( ! this_instance->Client_only )
431 /* Check for other way of setting Client-only !! */
433 this_instance->Client_only=(this_instance->CBF_Flags&CBF_FAIL_ALLSVRXACTIONS)
434 ==CBF_FAIL_ALLSVRXACTIONS;
437 TRACE(ddeml,"instance created - checking validity \n");
439 if( *pidInst == 0 ) {
440 /* Initialisation of new Instance Identifier */
441 TRACE(ddeml,"new instance, callback %p flags %lX\n",pfnCallback,afCmd);
442 if ( DDE_Max_Assigned_Instance == 0 )
444 /* Nothing has been initialised - exit now ! can return TRUE since effect is the same */
445 /* Need to set up Mutex in case it is not already present */
446 s_att->bInheritHandle = TRUE;
447 s_att->lpSecurityDescriptor = NULL;
448 s_att->nLength = sizeof(s_att);
449 handle_mutex = CreateMutexW(s_att,1,DDEHandleAccess);
450 if ( (err_no=GetLastError()) != 0 )
452 ERR(ddeml,"CreateMutex failed - handle list %li\n",err_no);
453 HeapFree(SystemHeap, 0, this_instance);
454 return DMLERR_SYS_ERROR;
456 } else
458 WaitForSingleObject(handle_mutex,1000);
459 if ( (err_no=GetLastError()) != 0 )
461 /* FIXME - needs refinement with popup for timeout, also is timeout interval OK */
463 ERR(ddeml,"WaitForSingleObject failed - handle list %li\n",err_no);
464 return DMLERR_SYS_ERROR;
468 TRACE(ddeml,"Handle Mutex created/reserved\n");
469 if (DDE_Handle_Table_Base == NULL )
471 /* can't be another instance in this case, assign to the base pointer */
472 DDE_Handle_Table_Base= this_instance;
474 /* since first must force filter of XTYP_CONNECT and XTYP_WILDCONNECT for
475 * present
476 * ------------------------------- NOTE NOTE NOTE --------------------------
478 * the manual is not clear if this condition
479 * applies to the first call to DdeInitialize from an application, or the
480 * first call for a given callback !!!
483 this_instance->CBF_Flags=this_instance->CBF_Flags|APPCMD_FILTERINITS;
484 TRACE(ddeml,"First application instance detected OK\n");
485 /* allocate new instance ID */
486 if ((err_no = IncrementInstanceId()) ) return err_no;
487 } else {
488 /* really need to chain the new one in to the latest here, but after checking conditions
489 * such as trying to start a conversation from an application trying to monitor */
490 reference_inst = DDE_Handle_Table_Base;
491 TRACE(ddeml,"Subsequent application instance - starting checks\n");
492 while ( reference_inst->Next_Entry != NULL )
495 * This set of tests will work if application uses same instance Id
496 * at application level once allocated - which is what manual implies
497 * should happen. If someone tries to be
498 * clever (lazy ?) it will fail to pick up that later calls are for
499 * the same application - should we trust them ?
501 if ( this_instance->Instance_id == reference_inst->Instance_id)
503 /* Check 1 - must be same Client-only state */
505 if ( this_instance->Client_only != reference_inst->Client_only)
507 if ( Release_reserved_mutex(handle_mutex,"handle_mutex",0,1))
508 return DMLERR_SYS_ERROR;
509 return DMLERR_DLL_USAGE;
512 /* Check 2 - cannot use 'Monitor' with any non-monitor modes */
514 if ( this_instance->Monitor != reference_inst->Monitor)
516 if ( Release_reserved_mutex(handle_mutex,"handle_mutex",0,1))
517 return DMLERR_SYS_ERROR;
518 return DMLERR_INVALIDPARAMETER;
521 /* Check 3 - must supply different callback address */
523 if ( this_instance->CallBack == reference_inst->CallBack)
525 if ( Release_reserved_mutex(handle_mutex,"handle_mutex",0,1))
526 return DMLERR_SYS_ERROR;
527 return DMLERR_DLL_USAGE;
530 reference_inst = reference_inst->Next_Entry;
532 /* All cleared, add to chain */
534 TRACE(ddeml,"Application Instance checks finished\n");
535 if ((err_no = IncrementInstanceId())) return err_no;
536 if ( Release_reserved_mutex(handle_mutex,"handle_mutex",0,0)) return DMLERR_SYS_ERROR;
537 reference_inst->Next_Entry = this_instance;
539 *pidInst = this_instance->Instance_id;
540 TRACE(ddeml,"New application instance processing finished OK\n");
541 } else {
542 /* Reinitialisation situation --- FIX */
543 TRACE(ddeml,"reinitialisation of (%p,%p,0x%lx,%ld): stub\n",pidInst,pfnCallback,afCmd,ulRes);
544 WaitForSingleObject(handle_mutex,1000);
545 if ( (err_no=GetLastError()) != 0 )
548 /* FIXME - needs refinement with popup for timeout, also is timeout interval OK */
550 ERR(ddeml,"WaitForSingleObject failed - handle list %li\n",err_no);
551 HeapFree(SystemHeap, 0, this_instance);
552 return DMLERR_SYS_ERROR;
554 if (DDE_Handle_Table_Base == NULL )
556 if ( Release_reserved_mutex(handle_mutex,"handle_mutex",0,1)) return DMLERR_SYS_ERROR;
557 return DMLERR_DLL_USAGE;
559 HeapFree(SystemHeap, 0, this_instance); /* finished - release heap space used as work store */
560 /* can't reinitialise if we have initialised nothing !! */
561 reference_inst = DDE_Handle_Table_Base;
562 /* must first check if we have been given a valid instance to re-initialise !! how do we do that ? */
564 * MS allows initialisation without specifying a callback, should we allow addition of the
565 * callback by a later call to initialise ? - if so this lot will have to change
567 while ( reference_inst->Next_Entry != NULL )
569 if ( *pidInst == reference_inst->Instance_id && pfnCallback == reference_inst->CallBack )
571 /* Check 1 - cannot change client-only mode if set via APPCMD_CLIENTONLY */
573 if ( reference_inst->Client_only )
575 if ((reference_inst->CBF_Flags & CBF_FAIL_ALLSVRXACTIONS) != CBF_FAIL_ALLSVRXACTIONS)
577 /* i.e. Was set to Client-only and through APPCMD_CLIENTONLY */
579 if ( ! ( afCmd & APPCMD_CLIENTONLY))
581 if ( Release_reserved_mutex(handle_mutex,"handle_mutex",0,1))
582 return DMLERR_SYS_ERROR;
583 return DMLERR_DLL_USAGE;
587 /* Check 2 - cannot change monitor modes */
589 if ( this_instance->Monitor != reference_inst->Monitor)
591 if ( Release_reserved_mutex(handle_mutex,"handle_mutex",0,1))
592 return DMLERR_SYS_ERROR;
593 return DMLERR_DLL_USAGE;
596 /* Check 3 - trying to set Client-only via APPCMD when not set so previously */
598 if (( afCmd&APPCMD_CLIENTONLY) && ! reference_inst->Client_only )
600 if ( Release_reserved_mutex(handle_mutex,"handle_mutex",0,1))
601 return DMLERR_SYS_ERROR;
602 return DMLERR_DLL_USAGE;
604 break;
606 reference_inst = reference_inst->Next_Entry;
608 if ( reference_inst->Next_Entry == NULL )
610 /* Crazy situation - trying to re-initialize something that has not beeen initialized !!
612 * Manual does not say what we do, cannot return DMLERR_NOT_INITIALIZED so what ?
614 if ( Release_reserved_mutex(handle_mutex,"handle_mutex",0,1))
615 return DMLERR_SYS_ERROR;
616 return DMLERR_INVALIDPARAMETER;
618 /* All checked - change relevant flags */
620 reference_inst->CBF_Flags = this_instance->CBF_Flags;
621 reference_inst->Client_only = this_instance->Client_only;
622 reference_inst->Monitor_flags = this_instance->Monitor_flags;
623 if ( Release_reserved_mutex(handle_mutex,"handle_mutex",0,1))
624 return DMLERR_SYS_ERROR;
627 return DMLERR_NO_ERROR;
631 /*****************************************************************
632 * DdeUninitialize16 (DDEML.3)
634 BOOL16 WINAPI DdeUninitialize16( DWORD idInst )
636 FIXME(ddeml," stub calling DdeUninitialize\n");
637 return (BOOL16)DdeUninitialize( idInst );
641 /*****************************************************************
642 * DdeUninitialize [USER32.119] Frees DDEML resources
644 * PARAMS
645 * idInst [I] Instance identifier
647 * RETURNS
648 * Success: TRUE
649 * Failure: FALSE
652 BOOL WINAPI DdeUninitialize( DWORD idInst )
654 /* Stage one - check if we have a handle for this instance
656 SECURITY_ATTRIBUTES s_attrib;
657 s_att = &s_attrib;
659 if ( DDE_Max_Assigned_Instance == 0 )
661 /* Nothing has been initialised - exit now ! can return TRUE since effect is the same */
662 return TRUE;
664 WaitForSingleObject(handle_mutex,1000);
665 if ( (err_no=GetLastError()) != 0 )
667 /* FIXME - needs refinement with popup for timeout, also is timeout interval OK */
669 ERR(ddeml,"WaitForSingleObject failed - handle list %li\n",err_no);
670 return DMLERR_SYS_ERROR;
672 TRACE(ddeml,"Uninitialize - Handle Mutex created/reserved\n");
673 /* First check instance
675 this_instance = Find_Instance_Entry(idInst);
676 if ( this_instance == NULL )
678 if ( Release_reserved_mutex(handle_mutex,"handle_mutex",FALSE,FALSE)) return FALSE;
680 * Needs something here to record NOT_INITIALIZED ready for DdeGetLastError
682 return FALSE;
684 FIXME(ddeml, "(%ld): partial stub\n", idInst);
686 /* Free the nodes that were not freed by this instance
687 * and remove the nodes from the list of HSZ nodes.
689 FreeAndRemoveHSZNodes( idInst );
691 /* OK now delete the instance handle itself */
693 if ( DDE_Handle_Table_Base == this_instance )
695 /* special case - the first/only entry
697 DDE_Handle_Table_Base = this_instance->Next_Entry;
698 } else
700 /* general case
702 reference_inst->Next_Entry = DDE_Handle_Table_Base;
703 while ( reference_inst->Next_Entry != this_instance )
705 reference_inst = this_instance->Next_Entry;
707 reference_inst->Next_Entry = this_instance->Next_Entry;
709 /* release the mutex and the heap entry
711 if ( Release_reserved_mutex(handle_mutex,"handle_mutex",FALSE,TRUE))
713 /* should record something here, but nothing left to hang it from !!
715 return FALSE;
717 return TRUE;
721 /*****************************************************************
722 * DdeConnectList16 [DDEML.4]
725 HCONVLIST WINAPI DdeConnectList16( DWORD idInst, HSZ hszService, HSZ hszTopic,
726 HCONVLIST hConvList, LPCONVCONTEXT16 pCC )
728 return DdeConnectList(idInst, hszService, hszTopic, hConvList,
729 (LPCONVCONTEXT)pCC);
733 /******************************************************************************
734 * DdeConnectList [USER32.93] Establishes conversation with DDE servers
736 * PARAMS
737 * idInst [I] Instance identifier
738 * hszService [I] Handle to service name string
739 * hszTopic [I] Handle to topic name string
740 * hConvList [I] Handle to conversation list
741 * pCC [I] Pointer to structure with context data
743 * RETURNS
744 * Success: Handle to new conversation list
745 * Failure: 0
747 HCONVLIST WINAPI DdeConnectList( DWORD idInst, HSZ hszService, HSZ hszTopic,
748 HCONVLIST hConvList, LPCONVCONTEXT pCC )
750 FIXME(ddeml, "(%ld,%ld,%ld,%ld,%p): stub\n", idInst, hszService, hszTopic,
751 hConvList,pCC);
752 return 1;
756 /*****************************************************************
757 * DdeQueryNextServer16 [DDEML.5]
759 HCONV WINAPI DdeQueryNextServer16( HCONVLIST hConvList, HCONV hConvPrev )
761 return DdeQueryNextServer(hConvList, hConvPrev);
765 /*****************************************************************
766 * DdeQueryNextServer [USER32.112]
768 HCONV WINAPI DdeQueryNextServer( HCONVLIST hConvList, HCONV hConvPrev )
770 FIXME(ddeml, "(%ld,%ld): stub\n",hConvList,hConvPrev);
771 return 0;
774 /*****************************************************************
775 * DdeQueryStringA [USER32.113]
777 *****************************************************************
779 * Change History
781 * Vn Date Author Comment
783 * 1.0 Dec 1998 Corel/Macadamian Initial version
786 DWORD WINAPI DdeQueryStringA(DWORD idInst, HSZ hsz, LPSTR psz, DWORD cchMax, INT iCodePage)
788 DWORD ret = 0;
789 CHAR pString[MAX_BUFFER_LEN];
791 FIXME(ddeml,
792 "(%ld, 0x%lx, %p, %ld, %d): stub\n",
793 idInst,
794 hsz,
795 psz,
796 cchMax,
797 iCodePage);
799 if( iCodePage == CP_WINANSI )
801 /* If psz is null, we have to return only the length
802 * of the string.
804 if( psz == NULL )
806 psz = pString;
807 cchMax = MAX_BUFFER_LEN;
810 ret = GlobalGetAtomNameA( hsz, (LPSTR)psz, cchMax );
813 return ret;
816 /*****************************************************************
817 * DdeQueryStringW [USER32.114]
819 *****************************************************************
821 * Change History
823 * Vn Date Author Comment
825 * 1.0 Dec 1998 Corel/Macadamian Initial version
829 DWORD WINAPI DdeQueryStringW(DWORD idInst, HSZ hsz, LPWSTR psz, DWORD cchMax, INT iCodePage)
831 DWORD ret = 0;
832 WCHAR pString[MAX_BUFFER_LEN];
833 int factor = 1;
835 FIXME(ddeml,
836 "(%ld, 0x%lx, %p, %ld, %d): stub\n",
837 idInst,
838 hsz,
839 psz,
840 cchMax,
841 iCodePage);
843 if( iCodePage == CP_WINUNICODE )
845 /* If psz is null, we have to return only the length
846 * of the string.
848 if( psz == NULL )
850 psz = pString;
851 cchMax = MAX_BUFFER_LEN;
852 /* Note: According to documentation if the psz parameter
853 * was NULL this API must return the length of the string in bytes.
855 factor = (int) sizeof(WCHAR)/sizeof(BYTE);
857 ret = GlobalGetAtomNameW( hsz, (LPWSTR)psz, cchMax ) * factor;
859 return ret;
862 /*****************************************************************
864 * DdeQueryString16 (DDEML.23)
866 ******************************************************************
868 * Change History
870 * Vn Date Author Comment
872 * 1.0 March 1999 K Matthews stub only
875 DWORD WINAPI DdeQueryString16(DWORD idInst, HSZ hsz, LPSTR lpsz, DWORD cchMax, int codepage)
877 FIXME(ddeml,"(%ld, 0x%lx, %p, %ld, %d): stub \n",
878 idInst,
879 hsz,
880 lpsz,
881 cchMax,
882 codepage);
883 return 0;
887 /*****************************************************************
888 * DdeDisconnectList (DDEML.6)
890 BOOL16 WINAPI DdeDisconnectList16( HCONVLIST hConvList )
892 return (BOOL16)DdeDisconnectList(hConvList);
896 /******************************************************************************
897 * DdeDisconnectList [USER32.98] Destroys list and terminates conversations
899 * RETURNS
900 * Success: TRUE
901 * Failure: FALSE
903 BOOL WINAPI DdeDisconnectList(
904 HCONVLIST hConvList) /* [in] Handle to conversation list */
906 FIXME(ddeml, "(%ld): stub\n", hConvList);
907 return TRUE;
911 /*****************************************************************
912 * DdeConnect16 (DDEML.7)
914 HCONV WINAPI DdeConnect16( DWORD idInst, HSZ hszService, HSZ hszTopic,
915 LPCONVCONTEXT16 pCC )
917 FIXME( ddeml, "empty stub\n" );
918 return 0;
922 /*****************************************************************
923 * DdeConnect (USER32.92)
925 HCONV WINAPI DdeConnect( DWORD idInst, HSZ hszService, HSZ hszTopic,
926 LPCONVCONTEXT pCC )
928 FIXME(ddeml, "(0x%lx,%ld,%ld,%p): stub\n",idInst,hszService,hszTopic,
929 pCC);
930 return 0;
934 /*****************************************************************
935 * DdeDisconnect16 (DDEML.8)
937 BOOL16 WINAPI DdeDisconnect16( HCONV hConv )
939 return (BOOL16)DdeDisconnect( hConv );
942 /*****************************************************************
943 * DdeSetUserHandle16 (DDEML.10)
945 BOOL16 WINAPI DdeSetUserHandle16( HCONV hConv, DWORD id, DWORD hUser )
947 FIXME( ddeml, "(%ld,%ld,%ld): stub\n",hConv,id, hUser );
948 return 0;
951 /*****************************************************************
952 * DdeCreateDataHandle16 (DDEML.14)
954 HDDEDATA WINAPI DdeCreateDataHandle16( DWORD idInst, LPBYTE pSrc, DWORD cb,
955 DWORD cbOff, HSZ hszItem, UINT16 wFmt,
956 UINT16 afCmd )
958 return DdeCreateDataHandle(idInst,
959 pSrc,
961 cbOff,
962 hszItem,
963 wFmt,
964 afCmd);
967 /*****************************************************************
968 * DdeCreateDataHandle (USER32.94)
970 HDDEDATA WINAPI DdeCreateDataHandle( DWORD idInst, LPBYTE pSrc, DWORD cb,
971 DWORD cbOff, HSZ hszItem, UINT wFmt,
972 UINT afCmd )
974 FIXME( ddeml,
975 "(%ld,%p,%ld,%ld,0x%lx,%d,%d): stub\n",
976 idInst,
977 pSrc,
979 cbOff,
980 hszItem,
981 wFmt,
982 afCmd );
984 return 0;
987 /*****************************************************************
988 * DdeDisconnect (USER32.97)
990 BOOL WINAPI DdeDisconnect( HCONV hConv )
992 FIXME( ddeml, "empty stub\n" );
993 return 0;
997 /*****************************************************************
998 * DdeReconnect (DDEML.37) (USER32.115)
1000 HCONV WINAPI DdeReconnect( HCONV hConv )
1002 FIXME( ddeml, "empty stub\n" );
1003 return 0;
1007 /*****************************************************************
1008 * DdeCreateStringHandle16 (DDEML.21)
1010 HSZ WINAPI DdeCreateStringHandle16( DWORD idInst, LPCSTR str, INT16 codepage )
1012 return DdeCreateStringHandleA( idInst, str, codepage );
1016 /*****************************************************************
1017 * DdeCreateStringHandleA [USER32.95]
1019 * RETURNS
1020 * Success: String handle
1021 * Failure: 1
1023 *****************************************************************
1025 * Change History
1027 * Vn Date Author Comment
1029 * 1.0 Dec 1998 Corel/Macadamian Initial version
1030 * 1.1 Mar 1999 Keith Matthews Added links to instance table and related processing
1033 HSZ WINAPI DdeCreateStringHandleA( DWORD idInst, LPCSTR psz, INT codepage )
1035 HSZ hsz = 0;
1036 SECURITY_ATTRIBUTES s_attrib;
1037 s_att = &s_attrib;
1038 TRACE(ddeml, "(%ld,%s,%d): partial stub\n",idInst,debugstr_a(psz),codepage);
1041 if ( DDE_Max_Assigned_Instance == 0 )
1043 /* Nothing has been initialised - exit now ! can return TRUE since effect is the same */
1044 return TRUE;
1046 WaitForSingleObject(handle_mutex,1000);
1047 if ( (err_no=GetLastError()) != 0 )
1049 /* FIXME - needs refinement with popup for timeout, also is timeout interval OK */
1051 ERR(ddeml,"WaitForSingleObject failed - handle list %li\n",err_no);
1052 return DMLERR_SYS_ERROR;
1054 TRACE(ddeml,"Handle Mutex created/reserved\n");
1056 /* First check instance
1058 reference_inst = Find_Instance_Entry(idInst);
1059 if ( reference_inst == NULL )
1061 if ( Release_reserved_mutex(handle_mutex,"handle_mutex",FALSE,FALSE)) return 0;
1063 Needs something here to record NOT_INITIALIZED ready for DdeGetLastError
1065 return 0;
1068 if (codepage==CP_WINANSI)
1070 hsz = GlobalAddAtomA (psz);
1071 /* Save the handle so we know to clean it when
1072 * uninitialize is called.
1074 InsertHSZNode( hsz );
1075 if ( Release_reserved_mutex(handle_mutex,"handle_mutex",FALSE,FALSE))
1077 reference_inst->Last_Error = DMLERR_SYS_ERROR;
1078 return 0;
1080 TRACE(ddeml,"Returning pointer\n");
1081 return hsz;
1083 TRACE(ddeml,"Returning error\n");
1084 return 0;
1088 /******************************************************************************
1089 * DdeCreateStringHandleW [USER32.96] Creates handle to identify string
1091 * RETURNS
1092 * Success: String handle
1093 * Failure: 0
1095 *****************************************************************
1097 * Change History
1099 * Vn Date Author Comment
1101 * 1.0 Dec 1998 Corel/Macadamian Initial version
1102 * 1.1 Mar 1999 Keith Matthews Added links to instance table and related processing
1105 HSZ WINAPI DdeCreateStringHandleW(
1106 DWORD idInst, /* [in] Instance identifier */
1107 LPCWSTR psz, /* [in] Pointer to string */
1108 INT codepage) /* [in] Code page identifier */
1110 HSZ hsz = 0;
1111 SECURITY_ATTRIBUTES s_attrib;
1112 s_att = &s_attrib;
1114 /* Need to set up Mutex in case it is not already present */
1115 s_att->bInheritHandle = TRUE;
1116 s_att->lpSecurityDescriptor = NULL;
1117 s_att->nLength = sizeof(s_att);
1118 handle_mutex = CreateMutexW(s_att,1,DDEHandleAccess);
1119 if ( (err_no=GetLastError()) != 0 )
1121 ERR(ddeml,"CreateMutex failed - handle list %li\n",err_no);
1122 return 0;
1124 TRACE(ddeml,"CreateString - Handle Mutex created/reserved\n");
1125 /* First check instance
1127 reference_inst = Find_Instance_Entry(idInst);
1128 if ( reference_inst == NULL )
1130 if ( Release_reserved_mutex(handle_mutex,"handle_mutex",FALSE,FALSE)) return 0;
1132 Needs something here to record NOT_INITIALIZED ready for DdeGetLastError
1134 return 0;
1137 FIXME(ddeml, "(%ld,%s,%d): partial stub\n",idInst,debugstr_w(psz),codepage);
1139 if (codepage==CP_WINUNICODE)
1141 Should we be checking this against the unicode/ascii nature of the call to DdeInitialize ?
1144 hsz = GlobalAddAtomW (psz);
1145 /* Save the handle so we know to clean it when
1146 * uninitialize is called.
1148 InsertHSZNode( hsz );
1149 if ( Release_reserved_mutex(handle_mutex,"handle_mutex",FALSE,FALSE))
1151 reference_inst->Last_Error = DMLERR_SYS_ERROR;
1152 return 0;
1154 return hsz;
1156 return 0;
1160 /*****************************************************************
1161 * DdeFreeStringHandle16 (DDEML.22)
1163 BOOL16 WINAPI DdeFreeStringHandle16( DWORD idInst, HSZ hsz )
1165 FIXME(ddeml,"idInst %ld hsz 0x%lx\n",idInst,hsz);
1166 return (BOOL)DdeFreeStringHandle( idInst, hsz );
1170 /*****************************************************************
1171 * DdeFreeStringHandle (USER32.101)
1172 * RETURNS: success: nonzero
1173 * fail: zero
1175 BOOL WINAPI DdeFreeStringHandle( DWORD idInst, HSZ hsz )
1177 TRACE( ddeml, "(%ld,%ld): stub\n",idInst, hsz );
1178 /* Remove the node associated with this HSZ.
1180 RemoveHSZNode( hsz );
1181 /* Free the string associated with this HSZ.
1183 return GlobalDeleteAtom (hsz) ? 0 : hsz;
1187 /*****************************************************************
1188 * DdeFreeDataHandle16 (DDEML.19)
1190 BOOL16 WINAPI DdeFreeDataHandle16( HDDEDATA hData )
1192 return (BOOL)DdeFreeDataHandle( hData );
1196 /*****************************************************************
1197 * DdeFreeDataHandle (USER32.100)
1199 BOOL WINAPI DdeFreeDataHandle( HDDEDATA hData )
1201 FIXME( ddeml, "empty stub\n" );
1202 return TRUE;
1208 /*****************************************************************
1209 * DdeKeepStringHandle16 (DDEML.24)
1211 BOOL16 WINAPI DdeKeepStringHandle16( DWORD idInst, HSZ hsz )
1213 return (BOOL)DdeKeepStringHandle( idInst, hsz );
1217 /*****************************************************************
1218 * DdeKeepStringHandle (USER32.108)
1220 BOOL WINAPI DdeKeepStringHandle( DWORD idInst, HSZ hsz )
1222 FIXME( ddeml, "empty stub\n" );
1223 return TRUE;
1227 /*****************************************************************
1228 * DdeClientTransaction16 (DDEML.11)
1230 HDDEDATA WINAPI DdeClientTransaction16( LPVOID pData, DWORD cbData,
1231 HCONV hConv, HSZ hszItem, UINT16 wFmt,
1232 UINT16 wType, DWORD dwTimeout,
1233 LPDWORD pdwResult )
1235 return DdeClientTransaction( (LPBYTE)pData, cbData, hConv, hszItem,
1236 wFmt, wType, dwTimeout, pdwResult );
1240 /*****************************************************************
1241 * DdeClientTransaction (USER32.90)
1243 HDDEDATA WINAPI DdeClientTransaction( LPBYTE pData, DWORD cbData,
1244 HCONV hConv, HSZ hszItem, UINT wFmt,
1245 UINT wType, DWORD dwTimeout,
1246 LPDWORD pdwResult )
1248 FIXME( ddeml, "empty stub\n" );
1249 return 0;
1252 /*****************************************************************
1254 * DdeAbandonTransaction16 (DDEML.12)
1257 BOOL16 WINAPI DdeAbandonTransaction16( DWORD idInst, HCONV hConv,
1258 DWORD idTransaction )
1260 FIXME( ddeml, "empty stub\n" );
1261 return TRUE;
1265 /*****************************************************************
1267 * DdeAbandonTransaction (USER32.87)
1269 ******************************************************************
1271 * Change History
1273 * Vn Date Author Comment
1275 * 1.0 March 1999 K Matthews stub only
1277 BOOL WINAPI DdeAbandonTransaction( DWORD idInst, HCONV hConv,
1278 DWORD idTransaction )
1280 FIXME( ddeml, "empty stub\n" );
1281 return TRUE;
1284 /*****************************************************************
1285 * DdePostAdvise16 [DDEML.13]
1287 BOOL16 WINAPI DdePostAdvise16( DWORD idInst, HSZ hszTopic, HSZ hszItem )
1289 return (BOOL16)DdePostAdvise(idInst, hszTopic, hszItem);
1293 /******************************************************************************
1294 * DdePostAdvise [USER32.110] Send transaction to DDE callback function.
1296 * RETURNS
1297 * Success: TRUE
1298 * Failure: FALSE
1300 BOOL WINAPI DdePostAdvise(
1301 DWORD idInst, /* [in] Instance identifier */
1302 HSZ hszTopic, /* [in] Handle to topic name string */
1303 HSZ hszItem) /* [in] Handle to item name string */
1305 FIXME(ddeml, "(%ld,%ld,%ld): stub\n",idInst,hszTopic,hszItem);
1306 return TRUE;
1310 /*****************************************************************
1311 * DdeAddData16 (DDEML.15)
1313 HDDEDATA WINAPI DdeAddData16( HDDEDATA hData, LPBYTE pSrc, DWORD cb,
1314 DWORD cbOff )
1316 FIXME( ddeml, "empty stub\n" );
1317 return 0;
1320 /*****************************************************************
1322 * DdeAddData (USER32.89)
1324 ******************************************************************
1326 * Change History
1328 * Vn Date Author Comment
1330 * 1.0 March 1999 K Matthews stub only
1332 HDDEDATA WINAPI DdeAddData( HDDEDATA hData, LPBYTE pSrc, DWORD cb,
1333 DWORD cbOff )
1335 FIXME( ddeml, "empty stub\n" );
1336 return 0;
1340 /*****************************************************************
1342 * DdeImpersonateClient (USER32.105)
1344 ******************************************************************
1346 * Change History
1348 * Vn Date Author Comment
1350 * 1.0 March 1999 K Matthews stub only
1353 BOOL WINAPI DdeImpersonateClient( HCONV hConv)
1355 FIXME( ddeml, "empty stub\n" );
1356 return TRUE;
1360 /*****************************************************************
1362 * DdeSetQualityOfService (USER32.116)
1364 ******************************************************************
1366 * Change History
1368 * Vn Date Author Comment
1370 * 1.0 March 1999 K Matthews stub only
1373 BOOL WINAPI DdeSetQualityOfService( HWND hwndClient, CONST SECURITY_QUALITY_OF_SERVICE *pqosNew,
1374 PSECURITY_QUALITY_OF_SERVICE pqosPrev)
1376 FIXME( ddeml, "empty stub\n" );
1377 return TRUE;
1380 /*****************************************************************
1382 * DdeSetUserHandle (USER32.117)
1384 ******************************************************************
1386 * Change History
1388 * Vn Date Author Comment
1390 * 1.0 March 1999 K Matthews stub only
1393 BOOL WINAPI DdeSetUserHandle( HCONV hConv, DWORD id, DWORD hUser)
1395 FIXME( ddeml, "empty stub\n" );
1396 return TRUE;
1399 /******************************************************************************
1400 * DdeGetData [USER32.102] Copies data from DDE object ot local buffer
1402 * RETURNS
1403 * Size of memory object associated with handle
1405 DWORD WINAPI DdeGetData(
1406 HDDEDATA hData, /* [in] Handle to DDE object */
1407 LPBYTE pDst, /* [in] Pointer to destination buffer */
1408 DWORD cbMax, /* [in] Amount of data to copy */
1409 DWORD cbOff) /* [in] Offset to beginning of data */
1411 FIXME(ddeml, "(%ld,%p,%ld,%ld): stub\n",hData,pDst,cbMax,cbOff);
1412 return cbMax;
1416 /*****************************************************************
1417 * DdeGetData16 [DDEML.16]
1419 DWORD WINAPI DdeGetData16(
1420 HDDEDATA hData,
1421 LPBYTE pDst,
1422 DWORD cbMax,
1423 DWORD cbOff)
1425 return DdeGetData(hData, pDst, cbMax, cbOff);
1429 /*****************************************************************
1430 * DdeAccessData16 (DDEML.17)
1432 LPBYTE WINAPI DdeAccessData16( HDDEDATA hData, LPDWORD pcbDataSize )
1434 return DdeAccessData(hData, pcbDataSize);
1437 /*****************************************************************
1438 * DdeAccessData (USER32.88)
1440 LPBYTE WINAPI DdeAccessData( HDDEDATA hData, LPDWORD pcbDataSize )
1442 FIXME( ddeml, "(%ld,%p): stub\n", hData, pcbDataSize);
1443 return 0;
1446 /*****************************************************************
1447 * DdeUnaccessData16 (DDEML.18)
1449 BOOL16 WINAPI DdeUnaccessData16( HDDEDATA hData )
1451 return DdeUnaccessData(hData);
1454 /*****************************************************************
1455 * DdeUnaccessData (USER32.118)
1457 BOOL WINAPI DdeUnaccessData( HDDEDATA hData )
1459 FIXME( ddeml, "(0x%lx): stub\n", hData);
1461 return 0;
1464 /*****************************************************************
1465 * DdeEnableCallback16 (DDEML.26)
1467 BOOL16 WINAPI DdeEnableCallback16( DWORD idInst, HCONV hConv, UINT16 wCmd )
1469 return DdeEnableCallback(idInst, hConv, wCmd);
1472 /*****************************************************************
1473 * DdeEnableCallback (USER32.99)
1475 BOOL WINAPI DdeEnableCallback( DWORD idInst, HCONV hConv, UINT wCmd )
1477 FIXME( ddeml, "(%ld, 0x%lx, %d) stub\n", idInst, hConv, wCmd);
1479 return 0;
1482 /*****************************************************************
1483 * DdeNameService16 (DDEML.27)
1485 HDDEDATA WINAPI DdeNameService16( DWORD idInst, HSZ hsz1, HSZ hsz2,
1486 UINT16 afCmd )
1488 return DdeNameService( idInst, hsz1, hsz2, afCmd );
1492 /******************************************************************************
1493 * DdeNameService [USER32.109] {Un}registers service name of DDE server
1495 * PARAMS
1496 * idInst [I] Instance identifier
1497 * hsz1 [I] Handle to service name string
1498 * hsz2 [I] Reserved
1499 * afCmd [I] Service name flags
1501 * RETURNS
1502 * Success: Non-zero
1503 * Failure: 0
1505 HDDEDATA WINAPI DdeNameService( DWORD idInst, HSZ hsz1, HSZ hsz2,
1506 UINT afCmd )
1508 FIXME(ddeml, "(%ld,%ld,%ld,%d): stub\n",idInst,hsz1,hsz2,afCmd);
1509 return 1;
1513 /*****************************************************************
1514 * DdeGetLastError16 (DDEML.20)
1516 UINT16 WINAPI DdeGetLastError16( DWORD idInst )
1518 return (UINT16)DdeGetLastError( idInst );
1522 /******************************************************************************
1523 * DdeGetLastError [USER32.103] Gets most recent error code
1525 * PARAMS
1526 * idInst [I] Instance identifier
1528 * RETURNS
1529 * Last error code
1531 UINT WINAPI DdeGetLastError( DWORD idInst )
1533 FIXME(ddeml, "(%ld): stub\n",idInst);
1534 return 0;
1538 /*****************************************************************
1539 * DdeCmpStringHandles16 (DDEML.36)
1541 int WINAPI DdeCmpStringHandles16( HSZ hsz1, HSZ hsz2 )
1543 return DdeCmpStringHandles(hsz1, hsz2);
1546 /*****************************************************************
1547 * DdeCmpStringHandles (USER32.91)
1549 * Compares the value of two string handles. This comparison is
1550 * not case sensitive.
1552 * Returns:
1553 * -1 The value of hsz1 is zero or less than hsz2
1554 * 0 The values of hsz 1 and 2 are the same or both zero.
1555 * 1 The value of hsz2 is zero of less than hsz1
1557 int WINAPI DdeCmpStringHandles( HSZ hsz1, HSZ hsz2 )
1559 CHAR psz1[MAX_BUFFER_LEN];
1560 CHAR psz2[MAX_BUFFER_LEN];
1561 int ret = 0;
1562 int ret1, ret2;
1564 TRACE( ddeml, "handle 1, handle 2\n" );
1566 ret1 = GlobalGetAtomNameA( hsz1, psz1, MAX_BUFFER_LEN );
1567 ret2 = GlobalGetAtomNameA( hsz2, psz2, MAX_BUFFER_LEN );
1568 /* Make sure we found both strings.
1570 if( ret1 == 0 && ret2 == 0 )
1572 /* If both are not found, return both "zero strings".
1574 ret = 0;
1576 else if( ret1 == 0 )
1578 /* If hsz1 is a not found, return hsz1 is "zero string".
1580 ret = -1;
1582 else if( ret2 == 0 )
1584 /* If hsz2 is a not found, return hsz2 is "zero string".
1586 ret = 1;
1588 else
1590 /* Compare the two strings we got ( case insensitive ).
1592 ret = strcasecmp( psz1, psz2 );
1593 /* Since strcmp returns any number smaller than
1594 * 0 when the first string is found to be less than
1595 * the second one we must make sure we are returning
1596 * the proper values.
1598 if( ret < 0 )
1600 ret = -1;
1602 else if( ret > 0 )
1604 ret = 1;
1608 return ret;
1611 /*****************************************************************
1612 * PackDDElParam (USER32.414)
1614 * RETURNS
1615 * success: nonzero
1616 * failure: zero
1618 UINT WINAPI PackDDElParam(UINT msg, UINT uiLo, UINT uiHi)
1620 FIXME(ddeml, "stub.\n");
1621 return 0;
1625 /*****************************************************************
1626 * UnpackDDElParam (USER32.562)
1628 * RETURNS
1629 * success: nonzero
1630 * failure: zero
1632 UINT WINAPI UnpackDDElParam(UINT msg, UINT lParam,
1633 UINT *uiLo, UINT *uiHi)
1635 FIXME(ddeml, "stub.\n");
1636 return 0;
1640 /*****************************************************************
1641 * FreeDDElParam (USER32.204)
1643 * RETURNS
1644 * success: nonzero
1645 * failure: zero
1647 UINT WINAPI FreeDDElParam(UINT msg, UINT lParam)
1649 FIXME(ddeml, "stub.\n");
1650 return 0;
1653 /*****************************************************************
1654 * ReuseDDElParam (USER32.446)
1657 UINT WINAPI ReuseDDElParam(UINT lParam, UINT msgIn, UINT msgOut,
1658 UINT uiLi, UINT uiHi)
1660 FIXME(ddeml, "stub.\n");
1661 return 0;
1664 /******************************************************************
1665 * DdeQueryConvInfo16 (DDEML.9)
1668 UINT16 WINAPI DdeQueryConvInfo16( HCONV hconv, DWORD idTransaction , LPCONVINFO16 lpConvInfo)
1670 FIXME(ddeml,"stub.\n");
1671 return 0;
1675 /******************************************************************
1676 * DdeQueryConvInfo (USER32.111)
1679 UINT WINAPI DdeQueryConvInfo( HCONV hconv, DWORD idTransaction , LPCONVINFO lpConvInfo)
1681 FIXME(ddeml,"stub.\n");
1682 return 0;