lineGetAppPriority 함수(tapi.h)

아티클
08/26/2023

lineGetAppPriority 함수를 사용하면 애플리케이션이 특정 미디어 모드 또는 보조 전화 통신 요청 모드의 핸드오프 우선 순위 목록에 있는지 여부와 우선 순위 목록에서 해당 위치를 확인할 수 있습니다.

구문

LONG lineGetAppPriority(
  LPCSTR            lpszAppFilename,
  DWORD             dwMediaMode,
  LPLINEEXTENSIONID lpExtensionID,
  DWORD             dwRequestMode,
  LPVARSTRING       lpExtensionName,
  LPDWORD           lpdwPriority
);

매개 변수

lpszAppFilename

디렉터리 데이터 없이 애플리케이션 실행 모듈 파일 이름을 포함하는 문자열에 대한 포인터입니다. API 버전 2.0 이상에서 매개 변수는 긴 파일 이름 형식일 수 있으며, 그 중 8.3 파일 이름 형식은 적절한 하위 집합입니다. 긴 파일 이름은 8.3 파일 이름과 달리 대/소문자를 유지합니다. 두 파일 이름 형식 모두 대/소문자를 구분하지 않습니다. 자세한 내용은 파일 이름 규칙을 참조하세요. 2.0 이전의 API 버전에서 매개 변수는 파일 이름을 8.3 형식으로 지정해야 합니다. 긴 파일 이름을 사용할 수 없습니다.

dwMediaMode

우선 순위 데이터를 가져올 미디어 모드입니다. 값은 LINEMEDIAMODE_ 상수 중 하나일 수 있습니다. 단일 비트만 사용할 수 있습니다. 지원 전화 통신 요청에 대한 애플리케이션 우선 순위를 확인하는 경우 값 0을 사용해야 합니다.

lpExtensionID

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

dwRequestMode

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

lpExtensionName

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

lpdwPriority

TAPI가 지정된 미디어 또는 요청 모드에 대한 애플리케이션의 우선 순위를 쓰는 DWORD 크기 메모리 위치에 대한 포인터입니다. 값 0은 애플리케이션이 저장된 우선 순위 목록에 없으며 현재 지정된 미디어 모드의 소유권이 요청되었거나 지정된 요청 모드에 등록된 라인 디바이스가 없는 경우 반환됩니다.

2.0 이전의 API 버전에서는 애플리케이션이 지정된 미디어 모드에 대해 열려 있거나 지정된 요청에 대해 등록된 줄이 있지만 애플리케이션이 저장된 우선 순위 목록에 없는 경우 값 –1(0xFFFFFFFF)이 반환됩니다. 즉, 임시 우선 순위 목록에만 있습니다. API 버전 2.0 이상에서는 이 조건을 나타내기 위해 값 0이 반환됩니다.

그렇지 않으면 값은 목록의 애플리케이션 위치를 나타냅니다. 1 우선 순위가 가장 높고 우선 순위가 감소함을 나타내는 값이 증가합니다.

반환 값

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

LINEERR_INIFILECORRUPT, LINEERR_INVALREQUESTMODE, LINEERR_INVALAPPNAME, LINEERR_NOMEM, LINEERR_INVALMEDIAMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL.