ITDirectoryObjectUser：:p ut_IPPhonePrimary 方法 (rend.h)
[Rendezvous IP Telephony 會議控件和介面不適用於 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 |