IH323LineEx::SetAlias 方法

[SetAlias 不适用于 Windows Vista、Windows Server 2008 和操作系统的后续版本。 RTC 客户端 API 提供类似的功能。]

SetAlias 方法为地址配置默认的 H.323 别名。 此别名将在 H.323 呼叫设置交换中使用,以便另一方知道此方的名称。

再次调用此方法将覆盖以前的别名。

仅当 TSP 没有其他方法来查找正确的别名时,才会使用此接口上设置的别名。 将来,将守护程序支持添加到 TSP 中时,注册到守护程序或由守护程序分配的别名将替代通过此方法设置的任何内容。

语法

HRESULT SetAlias(
  [in] WCHAR *strAlias,
  [in] DWORD dwLength
);

参数

strAlias [in]

要使用的别名(在 Unicode 中)。 不需要 Null 终止。

dwLength [in]

别名的长度(以字符数为单位),包括 null 终止符。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
方法成功。
E_POINTER
dwLength 中指示的字符数超过了 strAlias 参数中的实际字符数。

要求

要求
TAPI 版本
需要 TAPI 3.0 或更高版本
标头
H323priv.h

Uuid.lib
DLL
Tapi3.dll