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 0x40, then ASCII-to-EBCDIC translation is not done.

nPipLength identifies the length of the program initialization parameters (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 that is used to return a handle to be used on subsequent calls. The handle is a unique value for each conversation.