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 |