lineRegisterRequestRecipient
The lineRegisterRequestRecipient
function registers the invoking application as a recipient of requests for the
specified request mode.
LONG lineRegisterRequestRecipient(
HLINEAPP hLineApp, |
|
DWORD dwRegistrationInstance, |
|
DWORD dwRequestMode, |
|
DWORD bEnable |
|
); |
|
Parameters
hLineApp
The
application's usage handle for the line portion of TAPI.
dwRegistrationInstance
An
application-specific DWORD that is passed back as a parameter of the LINE_REQUEST
dwRequestMode
The type or
types of request for which the application registers. One or both bits may be
set. This parameter uses the following LINEREQUESTMODE_ constants:
LINEREQUESTMODE_MAKECALL
A tapiRequestMakeCall
bEnable
If TRUE, the
application registers; if FALSE, the application deregisters for the specified
request modes.
Return Values
Returns zero
if the request is successful or a negative error number if an error has
occurred. Possible return values are:
LINEERR_INVALAPPHANDLE,
LINEERR_OPERATIONFAILED, LINEERR_INVALREQUESTMODE, LINEERR_RESOURCEUNAVAIL,
LINEERR_NOMEM, LINEERR_UNINITIALIZED.
Remarks
A
telephony-enabled application can request that a call be placed on its behalf
by invoking tapiRequestMakeCall. Additionally, other applications can
request that information be logged with a given call. The tapiRequestMakeCall
requests are queued by TAPI, and the highest priority application that has
registered to handle the request is sent a LINE_REQUEST message with an
indication of the mode of the request that is pending. This application is
typically the user's call-control application.
Next, the
call-control application that receives this message invokes lineGetRequest,
specifying the request mode and a buffer that is large enough to hold the
request. The call-control application then interprets and executes the request.
The recipient
application is also automatically deregistered for all requests when it does a lineShutdown.
See Also