lineTranslateAddressA 함수(tapi.h)

2024-11-20

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

통사론

LONG lineTranslateAddressA(
  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

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

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.

발언

메모

tapi.h 헤더는 LINETranslateAddress를 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.