IH323LineEx：：SetDefaultCapabilityPreferrence 方法

[SetDefaultCapabilityPreferrence 不適用於 Windows Vista、Windows Server 2008 和後續版本的作業系統。 RTC 用戶端 API 提供類似的功能。

SetDefaultCapabilityPreferrence方法會設定預設功能的喜好設定。功能的預設權數為 100。如果應用程式為功能指定較高的權數，在 H.245 交涉期間會有較高的優先順序。如果應用程式將功能的權數設定為 0，則不會在 H.245 交涉中使用。

這個方法是累加的。例如，如果先呼叫這個方法以停用功能，並再次呼叫以停用另一個功能，這兩個功能將會因為這兩個呼叫而停用。

語法

HRESULT SetDefaultCapabilityPreferrence(
  [in] DWORD           dwNumCaps,
  [in] H245_CAPABILITY *pCapabilities,
  [in] DWORD           *pWeights
);

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

傳回碼	描述
S_OK	方法成功。
E_OUTOFMEMORY	記憶體不足，無法執行作業。
E_INVALIDARG	pCapabilities參數為Null，或pWeights參數為Null，或pCapabilities和pWeights都是Null，或 pCapabilities 陣列包含不正確 H.245 功能物件。
E_POINTER	無法讀取 pWeights 陣列的專案或 pCapabilities 陣列的專案。