MagTek Excella STX99875340 - Manual (Page 28)

Excella Windows API Specifications
18
MTMICRDeviceConnect
MTMICRDeviceConnect function connects host to a device that has the given IP address or a DNS name.
ULONG MTMICRDeviceConnect (LPSTR lpszDevice,
INTERNET_PORT nServerPort,
DWORD dwAccessType,
LPSTR lpszProxyName,
LPSTR lpszProxyBypass);
Parameters
lpszDevice: Pointer to a null terminated string that contains the IP address or DNS name of the device.
nServerPort: Unsigned integer that specifies the TCP/IP port on the server to which a connection is made.
dwAccessType: Type of Internet access. This parameter can be one of the following values:
INTERNET_OPEN_TYPE_DIRECT
INTERNET_OPEN_TYPE_PRECONFIG
INTERNET_OPEN_TYPE_PROXY
INTERNET_OPEN_TYPE_PRECONFIG_WITH_NO_AUTOPROXY
lpszProxyName: Pointer to a null-terminated string that specifies the name of the proxy server to use when proxy access
is specified by setting dwAccessType to INTERNET_OPEN_TYPE_PROXY
.
lpszProxyBypass: Pointer to a null-terminated string that specifies an optional list of host names or IP
addresses, or both, that should not be routed through the proxy when dwAccessType
is set to INTERNET_OPEN_TYPE_PROXY
Return Values
If the function succeeds, the return value is MICR_ST_OK.
MICR_ST_OK
MICR_ST_BAD_DEVICE_IP_OR_DOMAIN_NAME
MICR_ST_DEVICE_NOT_RESPONDING
MICR_ST_MSXML_NOT_FOUND
MICR_ST_MSXML_FAILED
Remarks
If parameter lpszDevice is NULL, the return value is MICR_ST_BAD_DEVICE_IP_OR_DOMAIN_NAME.
If no device is found, the return value is MICR_ST_DEVICE_NOT_FOUND.
If MSXML is not installed, return value is MICR_ST_MSXML_NOT_FOUND
If MSXML cannot be instantiated, return value is MICR_ST_MSXML_FAILED
If device is found but cannot connect, return value is MICR_ST_DEVICE_NOT_RESPONDING