win12.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
WinDdeInitiate (1.2)
Function Group  Overview  Message Group         Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINDDE
 
BOOL WinDdeInitiate(hwndClient, pszAppName, pszTopicName)
HWND hwndClient;     /* handle of the client window */
PSZ pszAppName;      /* address of application name */
PSZ pszTopicName;    /* address of topic name       */
 
The WinDdeInitiate function initiates a DDE conversation by sending a
WM_DDE_INITIATE message. All server applications matching the supplied
application name will reply with a WM_DDE_INITIATEACK message if they
support the specified topic.
 
Parameter     Description
────────────────────────────────────────────────────────────────────────────
 
hwndClient    Identifies the client window. Since the window handle serves
              as the recipient of DDE messages for its conversation, it need
              not be visible. All applications must rely only on their own
              window handles to identify conversations.
 
pszAppName    Points to a NULL terminated string containing the server's
              application name. If the string has zero length, any server
              application may respond.
 
pszTopicName  Points to a NULL terminated string containing the topic name.
              If the string has zero length, the server will respond once
              for each topic that it supports.
 
Return Value
 
The return value is TRUE if the function is successful or FALSE if an error
occurs.
 
Comments
 
The WM_DDE_INITIATE message is sent to all top-level frame windows in the
system. Any prospective server must subclass a top-level frame window in
order to retrieve this message.
 
See Also
 
WinDdePostMsg, WinDdeRespond, WM_DDE_INITIATE, WM_DDE_INITIATEACK