lineProxyResponse function (tapi.h)

The lineProxyResponse function indicates completion of a proxy request by a registered proxy handler, such as an ACD agent handler on a server.

Syntax

LONG lineProxyResponse(
  HLINE              hLine,
  LPLINEPROXYREQUEST lpProxyRequest,
  DWORD              dwResult
);

Parameters

hLine

A handle to the open line device.

lpProxyRequest

A pointer to the proxy request buffer given to the application by TAPI in a LINE_PROXYREQUEST message. In the case of proxy requests that return data to the client application, the proxy handler should have filled in the necessary structure in this buffer before calling this function. The dwNeededSize and dwUsedSize members of the structure to be returned must have been set appropriately.

Note  If the size parameters in the structure are incorrect, it is possible that data could be overwritten. For more information about setting structure sizes, see memory allocation.
 

dwResult

A function result returned to the calling application in a LINE_REPLY message (generated automatically by TAPI). Must be zero or one of the negative error values defined for the called function.

Return value

Returns zero if the function succeeds or one of these negative error values:

LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOTREGISTERED, LINEERR_OPERATIONFAILED, LINE ERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

Requirements

Requirement Value
Target Platform Windows
Header tapi.h
Library Tapi32.lib
DLL Tapi32.dll

See also

Supplementary Line Service Functions

TAPI 2.2 Reference Overview