DOCUMENT:Q119646 12-NOV-1999 [pcmail] TITLE :PC Win: Undocumented Extension to Custom Command Syntax PRODUCT :Microsoft Mail For PC Networks PROD/VER:WINDOWS:3.0,3.0b,3.2 OPER/SYS: KEYWORDS: ====================================================================== ------------------------------------------------------------------------------- The information in this article applies to: - Microsoft Mail for Windows, versions 3.0, 3.0b, 3.2 ------------------------------------------------------------------------------- SUMMARY ======= With versions 3.0, 3.0b, and 3.2 of Microsoft Mail for Windows, you can create custom commands. There is an undocumented extension to the syntax for defining custom commands in the MSMAIL.INI file. The custom command can specify that a particular ordinal in a dynamic-link library (DLL) should be called by placing a comma and a number after the DLL name in the custom command entry. For example, the following entry specifies that ordinal 24 in the MSRMTUI.DLL file should be used: MSMRT:ConnectNow=3.0;view;Connect &Now...; -1; msrmtui.dll,24; ; *0000000000000000;Connect to Postoffice;MSRMT.HLP;6506 MORE INFORMATION ================ Chapter 1 of the Microsoft Mail "Technical Reference" describes how to create custom commands. According to the "Technical Reference," a custom command DLL must have the following function defined: long FAR PASCAL Command (PARAMBLK FAR * lpParamblk For more information about the PARAMBLK type, see the "Technical Reference." The "Technical Reference" specifies that this function must be exported with the ordinal number 1. Using the undocumented extension to the MSMAIL.INI syntax, the function can be exported with another ordinal number. In this case, the entry in the MSMAIL.INI file should refer to this new ordinal number. Additional query words: 3.00 3.00b 3.20 ====================================================================== Keywords : Technology : kbMailSearch kbZNotKeyword3 kbMail300 kbMail320 kbMail300b Version : WINDOWS:3.0,3.0b,3.2 ============================================================================= THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY. Copyright Microsoft Corporation 1999.