HP NonStop G-Series User Manual
Page 115

User Hook Library
Extending the Tandem DDE Gateway
110838 Tandem Computers Incorporated
8–13
Prototype
BOOL FAR PASCAL TdmgwHookGetRequestDdeSize
(HWND hMainWnd,
in
unsigned long ulInitializeServiceSerialNumber,
in
LPSTR lpServiceName,
in
struct tagDdeDictElementData far * pstructElementData,
in
WORD cfFormat,
in
unsigned int far * puRequestElementDdeSize,
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 DDE Request function.
puRequestElementDdeSize
Size of the data area to store the data converted
from the Tandem data representation to the
clipboard format cfFormat.
pstructErrMsg
See “Returning Error Messages” earlier in this
section.
TdmgwHookIsConvSupported
This function may be called when your client application does an element-by-element
DDE Request or DDE Poke function.
You must enable the function with TdmgwHookEnableUserHooks function by
returning a value with the TDMGW_HOOK_ENABLE_IS_CONV_SUP bit set.
On entry, pbSupportedFormat will contain a non-zero value if the built-in automatic
data conversion functions can convert between the clipboard format cfFormat and the
required Tandem data representation. The parameter pbSupportedFormat contains
zero if there is no built-in automatic data conversion.