IH323LineEx::SetDefaultCapabilityPreferrence メソッド

[SetDefaultCapabilityPreferrence は、Windows Vista、Windows Server 2008、および以降のバージョンのオペレーティング システムでは使用できません。 RTC クライアント API も同様の機能を提供します。

SetDefaultCapabilityPreferrence メソッドは、既定の機能の優先順位を構成します。 機能の既定の重みは 100 です。 アプリケーションが機能の重みを高く指定した場合、H.245 ネゴシエーション中に優先順位が高くなります。 アプリケーションで機能の重みを 0 に設定した場合、H.245 ネゴシエーションでは使用されません。

このメソッドは累積的です。 たとえば、このメソッドを最初に呼び出して機能を無効にし、もう一度呼び出して別の機能を無効にした場合、これら 2 つの呼び出しの結果として両方の機能が無効になります。

構文

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

パラメーター

dwNumCaps [in]

このメソッドで設定された機能の数を含む DWORD 値。

pCapabilities [in]

機能の配列。 配列の各要素は 、H245_CAPABILITY 値です。

pWeights [in]

機能に関連付けられている重みの配列。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード	説明
S_OK	メソッドが成功しました。
E_OUTOFMEMORY	操作を実行するためのメモリが不足しています。
E_INVALIDARG	pCapabilities パラメーターが NULL であるか、pWeights パラメーターが NULL であるか、pCapabilities と pWeights の両方が NULL であるか、pCapabilities 配列に無効な H.245 機能オブジェクトが含まれています。
E_POINTER	pWeights 配列の要素または pCapabilities 配列の要素を読み取ることができません。

要件

要件	値
TAPI バージョン	TAPI 3.0 以降が必要です
ヘッダー	H323priv.h
ライブラリ	Uuid.lib
[DLL]	Tapi3.dll