다음을 통해 공유

ITTAPI::SetApplicationPriority 메서드(tapi3if.h)

  • 아티클

SetApplicationPriority 메서드를 사용하면 애플리케이션이 특정 미디어 유형 또는 보조 전화 통신 요청 모드의 핸드오프 우선 순위 목록에서 우선 순위를 설정하거나 우선 순위 목록에서 자신을 제거할 수 있습니다.

구문

HRESULT SetApplicationPriority(
  [in] BSTR         pAppFilename,
  [in] long         lMediaType,
  [in] VARIANT_BOOL fPriority
);

매개 변수

[in] pAppFilename

애플리케이션 이름을 포함하는 BSTR 에 대한 포인터입니다.

[in] lMediaType

애플리케이션과 연결된 미디어입니다.

[in] fPriority

애플리케이션의 새 우선 순위입니다. VARIANT_FALSE 값이 전달되면 애플리케이션이 지정된 미디어 또는 요청 모드의 우선 순위 목록에서 제거됩니다(아직 없는 경우 오류가 생성되지 않음). VARIANT_TRUE 값이 전달되면 애플리케이션이 미디어 또는 요청 모드에 대한 우선 순위가 가장 높은 애플리케이션으로 삽입되고 목록에 이미 있는 경우 우선 순위가 낮은 위치에서 제거됩니다.

반환 값

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

반환 코드 Description
S_OK
 메서드가 정상적으로 실행되었습니다.
E_OUTOFMEMORY
 작업을 수행하기 위한 메모리가 부족합니다.

설명

애플리케이션은 SysAllocString을 사용하여 pAppFilename 매개 변수에 대한 메모리를 할당하고 SysFreeString을 사용하여 변수가 더 이상 필요하지 않을 때 메모리를 해제해야 합니다.

SetApplicationPriority로 설정된 우선 순위는 시스템을 다시 부팅하거나 tapisrv를 다시 시작할 때 유지됩니다. ITTAPI::RegisterCallNotifications 함수는 지정된 호출 우선 순위가 없는 줄을 엽니다. 기본적으로 우선 순위가 가장 높은 애플리케이션은 먼저 ITTAPI::RegisterCallNotifications를 호출한 애플리케이션입니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 tapi3if.h(Tapi3.h 포함)
라이브러리 Uuid.lib
DLL Tapi3.dll

추가 정보

ITBasicCallControl::HandoffIndirect

ITTAPI

TAPI 개체