HP NonStop G-Series - Manual (Page 113)

User Hook Library
Extending the Tandem DDE Gateway
110838 Tandem Computers Incorporated 8–11
in the pbSupportedFormat parameter and zero in the pbConvertWithOnlyHookCode
parameter.
The TdmgwHookDdeRequestPostConvert function is called after the automatic data
conversion is used. You can modify the converted data before it is returned to your
client application. The data is pointed to by the parameter
lpRequestDataElementValue and is in the clipboard format cfFormat.
You can override the default length of the data area pointed to by the parameter
lpRequestDataElementValue by using the TdmgwHookGetRequestDdeSize User
Hook Library function.
Prototype
BOOL FAR PASCAL TdmgwHookDdeRequestPostConvert
(HWND hMainWnd, in
unsigned long ulInitializeServiceSerialNumber, in
LPSTR lpServiceName, in
struct tagDdeDictElementData far * pstructElementData, in
WORD cfFormat, in
void far * lpRequestDataElementValue, in/out
struct tagTdmgwErrorMsg far * pstructErrMsg); out
Parameters
Return Value Zero = Error.
Non-zero = No error.
hMainWnd Window handle of Tandem DDE Gateway main
window.
ulInitializeServiceSerialNumber Number incremented with each
INITIALIZESERVICE command. Starts at zero
when the Tandem DDE Gateway is started.
Rolls over to zero after 4,294,967,295.
lpServiceName Current ServiceName object (from
INITIALIZESERVICE command).
pstructElementData Description of current data element. (See the
“Tandem DDE Gateway Dictionary Structure”
topic).
cfFormat Clipboard format of
lpRequestDataElementValue.
lpRequestDataElementValue Data value returned from the built-in automatic
data conversion (will be returned to the client
application that issued the DDE Request
function). Data is in the clipboard format
cfFormat.
pstructErrMsg See “Returning Error Messages” earlier in this
section.