lineSetCallData

The lineSetCallData function sets the CallData member in LINECALLINFO. Depending on the service provider implementation, the CallData member may be propagated to all applications having handles to the call, including those on other machines (through the server), and may travel with the call when it is transferred.

LONG lineSetCallData(

HCALL hCall,
LPVOID lpCallData,
DWORD dwSize
);

Parameters
hCall

Handle to the call. The application must have OWNER privilege.

lpCallData

Address of the data to be copied to the CallData member in LINECALLINFO, replacing any existing data.

dwSize

Number of bytes of data to be copied. A value of 0 causes any existing data to be removed.

Return Values
Returns a positive request identifier if the asynchronous operation starts; otherwise, one of these negative error values:

LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOTOWNER, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.