lineTranslateDialog 함수(tapi.h)

아티클
08/26/2023

lineTranslateDialog 함수는 사용자가 전화를 걸 전화 번호의 현재 위치를 변경하고, 위치를 조정하고, 카드 매개 변수를 호출하고, 효과를 볼 수 있는 애플리케이션 모달 대화 상자를 표시합니다.

구문

LONG lineTranslateDialog(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  HWND     hwndOwner,
  LPCSTR   lpszAddressIn
);

매개 변수

hLineApp

lineInitializeEx에서 반환된 애플리케이션 핸들입니다. 애플리케이션이 lineInitializeEx 함수를 아직 호출하지 않은 경우 hLineApp 매개 변수를 0으로 설정할 수 있습니다.

dwDeviceID

다른 줄의 전화 걸기 프로시저의 변형을 번역 프로세스에 적용할 수 있도록 통화가 전화를 걸려는 라인 디바이스의 디바이스 식별자입니다.

dwAPIVersion

애플리케이션에서 지원하는 가장 높은 버전의 TAPI(반드시 dwDeviceID로 표시된 라인 디바이스에서 lineNegotiateAPIVersion으로 협상된 값이 아님).

hwndOwner

대화 상자를 연결할 창에 대한 핸들입니다. 함수 중에 만든 창에 소유자 창이 없어야 함을 나타내는 NULL 값일 수 있습니다.

lpszAddressIn

대화 상자의 아래쪽 부분에서 사용되는 전화 번호가 포함된 null로 끝나는 문자열에 대한 포인터로, 사용자의 변경 내용이 위치 매개 변수에 미치는 영향을 표시합니다. 숫자는 정식 형식이어야 합니다. 비대화면 대화 상자의 전화 번호 부분이 표시되지 않습니다. 이 포인터는 NULL로 남겨둘 수 있습니다. 이 경우 대화 상자의 전화 번호 부분이 표시되지 않습니다. lpszAddressIn 매개 변수에 하위 주소 또는 이름 필드 또는 첫 번째 주소와 CR 및 LF 문자로 구분된 추가 주소가 포함된 경우 대화 상자에서 첫 번째 주소만 사용됩니다.

반환 값

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

LINEERR_BADDEVICEID, LINEERR_INVALPARAM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INVALPOINTER, LINEERR_INIFILECORRUPT, LINEERR_NODRIVER, LINEERR_INUSE, LINEERR_NOMEM, LINEERR_INVALADDRESS, LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED.

설명

TAPI 버전 2.0 이상에서는 이 대화 상자의 여러 인스턴스를 열 수 있습니다. 2.0 이전의 TAPI 버전에서는 대화 상자가 이미 다른 애플리케이션에 의해 표시되는 경우(두 번 이상 열 수 없음) LINEERR_INUSE 반환됩니다. 이러한 버전에서 TAPI는 기존 대화 상자를 맨 앞으로 가져오며, 오류는 해당 주소가 함수에서 처리되지 않았기 때문에 현재 애플리케이션에서 전달한 주소와 관련된 모든 세부 사항이 처리되지 않았다는 것을 나타냅니다.

애플리케이션은 사용자가 전화 통신 주소 변환 매개 변수를 변경한 내용을 가져오려면 이 함수 다음에 lineGetTranslateCaps 를 호출하고 lineTranslateAddress 를 호출하여 사용자의 새 선택에 따라 전화 걸기 문자열을 가져와야 합니다.

주소 변환과 관련된 함수(예: lineGetTranslateCaps 또는 lineTranslateAddress)가 LINEERR_INIFILECORRUPT 반환하는 경우 애플리케이션은 lineTranslateDialog를 호출해야 합니다. lineTranslateDialog 함수는 오류를 감지하고 수정하고 사용자에게 수행된 작업을 보고합니다.