lineTranslateAddress 함수(tapi.h)

아티클
08/26/2023

lineTranslateAddress 함수는 지정된 주소를 다른 형식으로 변환합니다.

구문

LONG lineTranslateAddress(
  HLINEAPP              hLineApp,
  DWORD                 dwDeviceID,
  DWORD                 dwAPIVersion,
  LPCSTR                lpszAddressIn,
  DWORD                 dwCard,
  DWORD                 dwTranslateOptions,
  LPLINETRANSLATEOUTPUT lpTranslateOutput
);

매개 변수

hLineApp

lineInitializeEx에서 반환된 핸들입니다. TAPI 2.x 애플리케이션이 lineInitializeEx 함수를 아직 호출하지 않은 경우 이 매개 변수를 NULL로 설정할 수 있습니다. TAPI 1.4 애플리케이션은 여전히 lineInitialize 를 먼저 호출해야 합니다.

dwDeviceID

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

dwAPIVersion

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

lpszAddressIn

번역을 위해 추출할 정보의 주소를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 정식 주소 형식 또는 임의의 전화 걸기 가능 숫자 문자열(비 정식)이어야 합니다. 이 매개 변수는 NULL이 아니어야 합니다. AddressIn에 하위 주소 또는 이름 필드 또는 CR 및 LF 문자로 첫 번째 주소와 구분된 추가 주소가 포함된 경우 첫 번째 주소만 번역됩니다.

dwCard

신용 카드 전화 걸기에 사용할 수 있습니다. 이 매개 변수는 CARDOVERRIDE 비트가 dwTranslateOptions에서 설정된 경우에만 유효합니다. 이 매개 변수는 CurrentLocation 정의에 지정된 PreferredCardID 대신 사용해야 하는 레지스트리의 [Cards] 섹션에 있는 카드 항목의 영구 식별자(lineTranslateCaps에서 가져온 것)를 지정합니다. 레지스트리에서 현재 위치 항목의 PreferredCardID 매개 변수가 수정되지는 않습니다. 재정의는 현재 번역 작업에만 적용됩니다. CARDOVERRIDE 비트가 dwTranslateOptions에서 설정되지 않은 경우 이 매개 변수는 무시됩니다.

dwTranslateOptions

주소를 전화 걸기 가능한 문자열로 변환하기 전에 수행할 관련 작업입니다. 이 매개 변수는 LINETRANSLATEOPTION_ 상수 중 하나를 사용합니다.

LINETRANSLATEOPTION_CANCELCALLWAITING 비트를 설정한 경우 LINECALLPARAMS 구조체의 dwCallParamFlags 멤버에서 LINECALLPARAMFLAGS_SECURE 비트를 설정하는 것이 좋습니다(lpCallParams 매개 변수를 통해 lineMakeCall에 전달됨). 이렇게 하면 회선 디바이스에서 전화 걸기 가능 숫자를 사용하여 통화 인터럽트 표시를 표시하지 않습니다.

lpTranslateOutput

LINETRANSLATEOUTPUT 형식의 변환 작업의 출력을 포함하는 애플리케이션 할당 메모리 영역에 대한 포인터입니다. lineTranslateAddress를 호출하기 전에 애플리케이션은 정보를 반환하기 위해 TAPI에 사용할 수 있는 메모리 양을 나타내기 위해 이 구조체의 dwTotalSize 멤버를 설정해야 합니다.

반환 값

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

LINEERR_BADDEVICEID, LINEERR_INVALPOINTER, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NODRIVER, LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCARD, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPARAM.