beautypg.com

HP NonStop G-Series User Manual

Page 115

background image

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.