When calling TCPMappingFilterQueryContextData or TCPMappingFilterSetContextData you specify a data value type to get or set. For queries the value is returned in a Schema Variant. For setting data values, the value is specified by a pointer and optionally a length.
The possible value for data values to get/set are:
| Item Type | Description | Type | strParam | Access |
|---|---|---|---|---|
| TCPMAPPING_DATA_SESSION_OBJ | The session relating to the current connection | NULL | Read | |
| TCPMAPPING_DATA_USER_OBJ | The user object | NULL | Read | |
| TCPMAPPING_DATA_SESSION_DESCRIPTION | The description of the session | Unicode string | NULL | Read/Write |
| TCPMAPPING_DATA_SESSION_INTERCEPTED | Was the connection intercepted | bool | NULL | Read |
| TCPMAPPING_DATA_SESSION_CLIENTIP | IP address of the client | Unicode string. IPv4 | NULL | Read |
| TCPMAPPING_DATA_SESSION_CLIENTPORT | Port of the client | unsigned int | NULL | Read |
| TCPMAPPING_DATA_SESSION_CLIENTSECURE | Is the client using TLS to WinGate? | bool | NULL | Read |
| TCPMAPPING_DATA_SESSION_LOCALIP | Local IP of connected client. IPv4 | Unicode string | NULL | Read |
| TCPMAPPING_DATA_SESSION_LOCALPORT | Local port of connected client | unsigned int | NULL | Read |
| TCPMAPPING_DATA_SESSION_DESTINATION | Destination name to connect to | Unicode string | NULL | Read/Write |
| TCPMAPPING_DATA_SESSION_DESTINATIONPORT | Destination port to connect to | unsigned int | NULL | Read/Write |
| TCPMAPPING_DATA_SESSION_DESTINATIONSECURE | Whether to use TLS to destination | bool | NULL | Read/Write |
Read only items can be read with TCPMappingFilterQueryContextData. Read/Write items can also be set with TCPMappingFilterSetContextData.
Some items require additional information when being set. This information is specified in the pData parameter of TCPMappingFilterSetContextData.
| Item Type | pData type | nLen required? |
|---|---|---|
| TCPMAPPING_DATA_SESSION_DESCRIPTION | LPCWSTR | No |
| TCPMAPPING_DATA_SESSION_DESTINATION | LPCWSTR | No |
| TCPMAPPING_DATA_SESSION_DESTINATIONPORT | UINT * | No |
| TCPMAPPING_DATA_SESSION_DESTINATIONSECURE | bool * | No |