ITDirectoryObjectUser：:p ut_IPPhonePrimary 方法 (rend.h)
[会合 IP 电话会议控件和接口不适用于 Windows Vista、Windows Server 2008 和操作系统的后续版本。 RTC 客户端 API 提供类似的功能。]
put_IPPhonePrimary 方法将计算机的名称设置为用户的主要 IP 电话。
语法
HRESULT put_IPPhonePrimary(
[in] BSTR pName
);
参数
[in] pName
指向用户 IP 主电话的 BSTR 表示形式的指针。
返回值
此方法可以返回其中一个值。
| 返回代码 | 说明 |
|---|---|
|
方法成功。 |
|
无效指针。 |
注解
此方法只能在随后添加到目录的新对象上使用。 如果应用程序要修改现有用户对象的 IP 电话，它必须枚举服务器中的对象以确定旧的 IP 电话。 这意味着 TAPI 3 应用程序正在一台或多台其他计算机上运行。 本地计算机上的应用程序没有有关其他应用程序是否仍在运行的信息。 因此，它不是应用程序更改现有用户对象上的 IP 电话的位置。
若要修改现有用户的 IP 电话，必须删除并重新添加该用户。
应用程序必须使用 SysAllocString 为 pName 参数分配内存，并在不再需要变量时使用 SysFreeString 释放内存。
此函数可能以未加密的形式通过网络发送数据;因此，在网络上窃听的人可能能够读取数据。 使用此方法之前，应考虑以明文形式发送数据的安全风险。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | rend.h |
| DLL | Rend.dll |