tapiRequestMakeCall 函数 (tapi.h)
tapiRequestMakeCall 函数请求建立语音呼叫。 呼叫管理器应用程序负责代表请求应用程序建立呼叫,然后由用户的呼叫管理器应用程序控制。
语法
LONG tapiRequestMakeCall(
LPCSTR lpszDestAddress,
LPCSTR lpszAppName,
LPCSTR lpszCalledParty,
LPCSTR lpszComment
);
参数
lpszDestAddress
指向调用请求的 以 null 结尾的目标地址所在的内存位置的指针。 地址可以使用 规范地址 格式。 此操作不会检查指定地址的有效性。 地址的最大长度为 TAPIMAXDESTADDRESSSIZE 字符,其中包括 NULL 终止符。
lpszAppName
指向调用请求的 以 null 结尾的用户友好应用程序名称所在的内存位置的指针。 如果应用程序不提供应用程序名称,则此指针可以为 NULL 。 地址的最大长度为 TAPIMAXAPPNAMESIZE 字符,其中包括 NULL 终止符。 超过最大长度的字符串会被截断。
lpszCalledParty
指向内存位置的指针,调用方以 null 结尾的被调用方名称位于该位置。 如果应用程序不希望提供此信息,则此指针可以为 NULL 。 字符串的最大长度为 TAPIMAXCALLEDPARTYSIZE 字符,其中包括 NULL 终止符。 超过最大长度的字符串会被截断。
lpszComment
指向内存位置的指针,其中有关调用的 以 null 结尾的注释位于该位置。 如果应用程序不提供注释,则此指针可以为 NULL 。 地址的最大长度为 TAPIMAXCOMMENTSIZE 字符,其中包括 NULL 终止符。 超过最大长度的字符串会被截断。
返回值
如果请求成功,则返回零;如果发生错误,则返回负错误号。 可能的错误返回值为:
TAPIERR_NOREQUESTRECIPIENT、TAPIERR_INVALDESTADDRESS、TAPIERR_REQUESTQUEUEFULL、TAPIERR_INVALPOINTER。
注解
启用电话服务的应用程序可以通过调用 tapiRequestMakeCall 来请求代表其进行呼叫,仅提供呼叫的目标地址。 此请求将转发到用户的呼叫控制应用程序,该应用程序代表原始应用程序发出呼叫。 默认呼叫控制应用程序作为电话的一部分提供。 用户可以将其替换为自己选择的呼叫控制应用程序。
在没有调用控制应用程序运行时调用 tapiRequestMakeCall 将返回TAPIERR_NOREQUESTRECIPIENT错误指示。 如果呼叫控制应用程序未运行,TAPI 会尝试启动优先级最高的呼叫控制应用程序 (该应用程序在注册表) 中为 RequestMakeCall 列出。 在辅助 TAPI 请求队列已满时调用此函数将返回TAPIERR_REQUESTQUEUEFULL错误。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tapi.h |
Library | Tapi32.lib |
DLL | Tapi32.dll |