HP NonStop G-Series User Manual
Page 106
User Hook Library
Extending the Tandem DDE Gateway
8–4
110838 Tandem Computers Incorporated
If you return a non-zero in the bCancel parameter, then connection attempts for the
PortName will be aborted.
Function Prototype
BOOL FAR PASCAL TdmgwRscLogon
(LPSTR lpPortName,
in
LPSTR lpDefaultUserId,
in
LPSTR lpDefaultPassword,
in
LPSTR lpReturnUserId,
out
LPSTR lpReturnPassword,
out
BOOL far * bCancel,
out
HWND hMainWnd,
in
LPSTR lpTdmgwIniFile,
in
LPSTR lpTextFile,
in
struct tagTdmgwErrorMsg far * pstructErrMsg);
out
Parameters
Return Value
Zero = Error.
Non-zero = No error.
lpPortName
PortName object name.
lpDefaultUserId
Default User ID from RSC USER_ID option (if specified) or a
null string.
lpDefaultPassword
Default password from RSC PASSWORD option (if specified) or
a null string.
lpReturnUserId
Return User ID. Maximum length is 20 bytes including the null
byte terminator.
lpReturnPassword
Return password. Maximum length is 20 bytes including the
null byte terminator.
bCancel
Zero = Don't cancel connection attempt
Non-zero = Cancel connection attempt
hMainWnd
Window handle of Tandem DDE Gateway main window.
lpTdmgwIniFile
File name of Tandem DDE Gateway configuration file.
lpTextFile
Name of error message text overrides file (specified with
DdeGatewayTextFile configuration option).
pstructErrMsg
See the topic “Returning Error Messages” earlier in this section.
User Hook Library
The User Hook Library is a dynamic link library (DLL) that you develop to extend the
Tandem DDE Gateway.
The User Hook Library consists of functions called by the Tandem DDE Gateway at
predefined points in its processing logic. Your code, packaged into a User Hook
Library, can thus become part of the Tandem DDE Gateway.