共用方式為

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