Microsoft KB Archive/105446

{|
 * width="100%"|

Win32 Shell Dynamic Data Exchange (DDE) Interface

 * }

Q105446

-

The information in this article applies to:


 * Microsoft Win32 Application Programming Interface (API), included with:
 * the operating system: Microsoft Windows NT, versions 3.5, 3.51

-

SUMMARY
Information on the DDE Interface to Program Manager can be found in the Win32 application programming interface (API) reference under the topic "Shell Dynamic Data Exchange Interface."

The SDK contains a sample program that interfaces with Program Manager. The sample can be found in MSTOOLS\SAMPLES\DDEML\DDEPROG.

MORE INFORMATION
AppProperties cannot be used to get the item icon, description, or working directory, as it can in Windows 3.1. Therefore, GetIcon, GetDescription, and GetWorkingDir do not work in Windows NT. However, AppProperties can still be used to dump out the contents of a group, by specifying the group name in lParam.

Here's how a Win32-based application can get the item icon, the description, and the working directory:

  Initiate a conversation with the Shell as follows      SendMessage( -1, WM_DDE_INITIATE, hWndApp, lParam ); where lParam points to an atom representing:      LOWORD | HIWORD ---

Shell | AppIcon        : To get an item's icon Shell | AppDescription : To get an item's description Shell | AppWorkingDir  : To get an item's working directory   Get the item DDE number.

The DDE number is stored by Program Manager in the STARUPINFO structure of the application when the application is started. The application can get the startup information with:      GetStartupInfo( &StartupInfo ); The field lpReserved in the STARUPINFO structure is in the following format "dde.#, hotkey.##" where the DDE number is # and the hot key for the item is ##.   Request data as follows      SendMessage( hwndProgMan, WM_DDE_REQUEST, hwndApp, lParam ); where the lParam HIWORD is the item's DDE number obtained in step 2.   The data is returned in lParam of WM_DDE_DATA message. The DDE data value is a string for AppDescription and AppWorkingDir DDE transactions. For AppIcon, the data value has the following structure:      typedef struct _PMIconData { DWORD dwResSize; DWORD dwVer; BYTE iResource; // icon resource } PMICONDATA, *LPPMICONDATA; To create the icon, the application must call:      hIcon = CreateIconFromResource((LPBYTE)&(lpPMIconData->iResource),                  lpPMIconData->dwResSize,                  TRUE,                  lpPMIconData->dwVer              ); 

Additional query words: 3.10 3.50

Keywords :

Issue type :

Technology : kbAudDeveloper kbWin32sSearch kbWin32API