Parameters

hWnd identifies the current window of the application.

nBufferLength identifies the size of the buffer to be allocated by the router. It must be at least 271. If it is less than 271, a 271–byte buffer will be allocated.

bType identifies the type of conversation to allocate. Possible values are:
  • EHNAPPC_BASIC (0)
  • EHNAPPC_MAPPED (1)
bSynchLevel identifies the synchronization level between the local and partner programs. Possible values are:
  • EHNAPPC_SYNCLEVELNONE (0)
  • EHNAPPC_SYNCLEVELCONFIRM (1)

lpszLocationName points to a null-terminated character string that specifies the host system name. If this pointer is set to NULL, the default system is used.

lpszTpn points to a null-terminated character string that specifies the partner program name. If the first character is less than X'40', then ASCII-to-EBCDIC translation is not done.

lpszModeName Mode names are one to eight characters long. The first character of each part must be an uppercase alphabetic character ( A–Z ), or on of the special characters (@, #, $). The remaining characters can be uppercase alphabetic characters ( A–Z ), numerals ( 0–9 ), or special characters (@, #, $).

bSecurityType identifies the security type to use. Possible values are:
  • EHNAPPC_SECURITY_NONE (0)
  • EHNAPPC_SECURITY_SAME (1)
  • EHNAPPC_SECURITY_PGM (2)

lpszUserId points to a null-terminated character string containing the user ID. The maximum length is 10 characters.

lpszPassword points to a null-terminated character string containing the password. The maximum length is 10 characters.

nPipLength identifies the length of the PIP data. If this variable is 0, no PIP data is sent.

lpPipData points to the PIP data. The PIP data must be in GDS format, and must be in EBCDIC.

lpdwConversation points to a doubleword variable which is used to return a handle to be used on subsequent calls.