lineSetAppPriority 함수(tapi.h)

아티클
03/08/2023

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

구문

LONG lineSetAppPriority(
  LPCSTR            lpszAppFilename,
  DWORD             dwMediaMode,
  LPLINEEXTENSIONID lpExtensionID,
  DWORD             dwRequestMode,
  LPCSTR            lpszExtensionName,
  DWORD             dwPriority
);

매개 변수

lpszAppFilename

디렉터리 데이터 없이 애플리케이션 실행 모듈 파일 이름을 포함하는 문자열에 대한 포인터입니다. TAPI 버전 2.0 이상에서 매개 변수는 긴 파일 이름 또는 8.3 파일 이름 형식으로 파일 이름을 지정할 수 있습니다.

dwMediaMode

애플리케이션의 우선 순위를 설정할 미디어 형식입니다. 값은 LINEMEDIAMODE 상수 중 하나 이상일 수 있습니다. 값 0은 보조 전화 통신 요청에 대한 애플리케이션 우선 순위를 설정하는 데 사용해야 합니다.

lpExtensionID

LINEEXTENSIONID 형식의 구조체에 대한 포인터입니다. 이 매개 변수는 무시됩니다.

dwRequestMode

이 매개 변수의 조건은 dwMediaMode 매개 변수가 0인 경우 이 매개 변수는 우선 순위를 설정할 보조 전화 통신 요청 모드를 지정합니다. LINEREQUESTMODE_MAKECALL 합니다. dwMediaMode가 0이 아닌 경우 이 매개 변수는 무시됩니다.

lpszExtensionName

이 매개 변수는 무시됩니다.

dwPriority

애플리케이션의 새 우선 순위를 나타내는 매개 변수입니다. 값 0이 전달되면 애플리케이션이 지정된 미디어 또는 요청 모드의 우선 순위 목록에서 제거됩니다. 아직 존재하지 않으면 오류가 생성되지 않습니다. 값 1이 전달되면 애플리케이션이 미디어 또는 요청 모드에 대한 우선 순위가 가장 높은 애플리케이션으로 삽입됩니다. 이미 목록에 있는 경우 우선 순위가 낮은 위치에서 제거됩니다. 다른 값은 오류를 생성합니다.

반환 값

요청이 성공하면 0을 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.

LINEERR_INIFILECORRUPT, LINEERR_INVALREQUESTMODE, LINEERR_INVALAPPNAME, LINEERR_NOMEM, LINEERR_INVALMEDIAMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER.

설명

LINEERR_INVALMEDIAMODE 반환되면 dwMediaMode에 지정된 값이 0이 아니고 LINEMEDIAMODE_ 상수 중 하나가 아닙니다.

이 함수는 저장된 우선 순위 목록을 업데이트합니다. 전화 통신 시스템이 초기화되면 애플리케이션에 대한 현재 활성 우선 순위도 설정한 다음 실행합니다. 새 우선 순위는 미디어 유형에 따라 다음 수신 통화 또는 lineHandoff 에 사용됩니다.

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