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 表示的指標。

傳回值

這個方法可以傳回其中一個值。

傳回碼 描述
S_OK
 方法成功。
E_POINTER
 無效的指標。

備註

這個方法只能在後續新增至目錄的新 物件上使用。 如果應用程式想要修改現有用戶物件的IP電話，它必須列舉伺服器中的物件，以判斷舊的IP電話。 這表示 TAPI 3 應用程式正在一或多部其他電腦上執行。 本機電腦上的應用程式沒有其他應用程式是否仍在執行中的資訊。 因此，它不是應用程式在現有使用者對象上變更IP電話的位置。

若要修改現有使用者的IP電話，必須刪除並重新新增使用者。

應用程式必須使用 SysAllocString 為 pName 參數配置記憶體，並使用 SysFreeString 在不再需要變數時釋放記憶體。

此函式可能會以未加密的形式透過網路傳送數據;因此，網路上有人竊聽可能會讀取數據。 使用此方法之前，應該考慮以純文本傳送數據的安全性風險。

規格需求

需求 值
目標平台 Windows
標頭 rend.h
Dll Rend.dll

另請參閱

ITDirectoryObjectUser

ITDirectoryObjectUser：：get_IPPhonePrimary