ExchangeData

The ExchangeData callback function should be provided by an application if they want to be able to exchange data with the ITP/Server server. If provided, the ExchangeData function is called for every exchange_data function call. The client can then process the data and send a response back.

TCHAR * (*ExchangeData) (
void *Context, // Context field of structure
TCHAR *Key, // The Key parameter
TCHAR *Value // The Value parameter
);
Parameters

Context, application defined data. This parameter gets the value of the Context field of the SUBMITJOB4/SUBMITJOB5 structure.

Key, the k parameter of the exchange_data function.

Value, the v parameter of the exchange_data function.

Return values

The ExchangeData function should return a pointer to the response it wants to send back to the ITP/Server server. The memory this pointer refers to must remain allocated until either the next call to ExchangeData or until the API returns.

The ExchangeData function can return NULL to indicate that the data was processed successfully without sending a specific response. In this situation the function exchange_data will return an empty text.

Remarks

The calling convention of the ExchangeData function is cdecl when it is passed through the SUBMITJOB4 data structure to SSubmitJobEx4, and stdcall when it is passed through the SUBMITJOB5 data structure to SSubmitJobEx5.

QuickInfo

Header, N/A.

Import Library, N/A.

Unicode, N/A.