다음을 통해 공유

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
);

매개 변수

dwNumCaps [in]

이 메서드로 설정된 기능 수를 포함하는 DWORD 값입니다.

pCapabilities [in]

기능 배열입니다. 배열의 각 요소는 H245_CAPABILITY 값입니다.

pWeights [in]

기능과 연결된 가중치 배열입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
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