tapiRequestDrop

Syntax

LONG tapiRequestDrop(hWnd, wRequestID)
This function requests that the call identified by hWnd and wRequestID be dropped. This call was established by the application by invoking tapiRequestMediaCall.

Parameters

HWND hWnd
Specifies the application's window handle.
WORD wRequestID
Specifies an application-selected ID that identifies the call. This value must match the value specified on the the corresponding tapiRequestMediaCall.

Return Value

Returns zero if the request was accepted or a negative error number if an error has occurred. Possible error returns are:
TAPIERR_INVALWINDOWHANDLE
The specified window handle is invalid.
TAPIERR_NOREQUESTRECIPIENT
No recipient application is available to handle the request. The user should start the application and try again.
TAPIERR_REQUESTQUEUEFULL
A recipient application is active, but the request queue is full. The app can try again later.

Comments

This request is forwarded to the same application that handles the tapiRequestMediaCall requests. It drops the call identified by hWnd and wRequestID. After the call is successfully dropped by the recipient application, a TAPI_REPLY message is sent with a dropped indication.

See Also

Functions: tapiRequestMediaCall
Messages: TAPI_REPLY