lineGetTranslateCaps 함수(tapi.h)

아티클
08/26/2023

lineGetTranslateCaps 함수는 주소 변환 기능을 반환합니다.

구문

LONG lineGetTranslateCaps(
  HLINEAPP            hLineApp,
  DWORD               dwAPIVersion,
  LPLINETRANSLATECAPS lpTranslateCaps
);

매개 변수

hLineApp

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

참고 TAPI 1.4 애플리케이션은 lineInitialize 함수에서 반환한 대로 이 매개 변수를 유효한 hLineApp 핸들로 설정해야 합니다.

dwAPIVersion

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

lpTranslateCaps

LINETRANSLATECAPS 구조체가 로드되는 위치에 대한 포인터입니다. lineGetTranslateCaps를 호출하기 전에 애플리케이션은 정보를 반환하기 위해 TAPI에 사용할 수 있는 메모리 양을 나타내기 위해 이 구조체의 dwTotalSize 멤버를 설정해야 합니다.

참고 구조의 크기 매개 변수가 올바르지 않으면 데이터를 덮어쓸 수 있습니다. 구조체 크기를 설정하는 방법에 대한 자세한 내용은 메모리 할당 항목을 참조하세요.

반환 값

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

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NODRIVER.