lineGetTranslateCapsA 함수(tapi.h)

아티클
2024. 11. 20.

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

통사론

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

매개 변수

hLineApp

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

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

dwAPIVersion

애플리케이션에서 지원하는 가장 높은 버전의 TAPI입니다(특정 라인 디바이스에서 lineNegotiateAPIVersion 협상한 값은 아님).

lpTranslateCaps

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

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

반환 값

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

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

발언

참고

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