LINECARDENTRY 구조체(tapi.h)

LINECARDENTRY 구조는 호출 카드 설명합니다. LINETRANSLATECAPS 구조체에는 LINECARDENTRY 구조체의 배열이 포함될 수 있습니다.

구문

typedef struct linecardentry_tag {
  DWORD dwPermanentCardID;
  DWORD dwCardNameSize;
  DWORD dwCardNameOffset;
  DWORD dwCardNumberDigits;
  DWORD dwSameAreaRuleSize;
  DWORD dwSameAreaRuleOffset;
  DWORD dwLongDistanceRuleSize;
  DWORD dwLongDistanceRuleOffset;
  DWORD dwInternationalRuleSize;
  DWORD dwInternationalRuleOffset;
  DWORD dwOptions;
} LINECARDENTRY, *LPLINECARDENTRY;

멤버

dwPermanentCardID

카드 식별하는 영구 식별자입니다.

dwCardNameSize

null 종결자를 포함한 카드 이름 문자열의 크기(바이트)입니다.

dwCardNameOffset

구조체의 시작 부분에서 사용자 친화적인 방식으로 카드 설명하는 null로 끝나는 문자열로 오프셋합니다. 필드의 크기는 dwCardNameSize로 지정됩니다.

dwCardNumberDigits

기존 카드 번호의 숫자 수입니다. 카드 번호 자체는 보안상의 이유로 반환되지 않습니다(TAPI에 의해 스크램블 형식으로 저장됨). 애플리케이션은 이를 사용하여 "암호" 모드의 텍스트 컨트롤에 필러 바이트를 삽입하여 숫자가 있음을 표시할 수 있습니다.

dwSameAreaRuleSize

null 종결자를 포함한 동일한 영역 전화 걸기 규칙의 크기(바이트)입니다.

dwSameAreaRuleOffset

LINETRANSLATECAPS 구조체의 시작부터 동일한 영역 코드의 숫자 호출에 대해 정의된 전화 걸기 규칙까지 오프셋합니다. 규칙은 null로 끝나는 문자열입니다. 필드의 크기는 dwSameAreaRuleSize로 지정됩니다.

dwLongDistanceRuleSize

null 종결자를 포함한 장거리 전화 걸기 규칙의 크기(바이트)입니다.

dwLongDistanceRuleOffset

구조체의 시작 부분에서 동일한 국가/지역의 다른 영역에 있는 번호 호출에 대해 정의된 전화 걸기 규칙까지 오프셋합니다. 규칙은 null로 끝나는 문자열입니다. 필드의 크기는 dwLongDistanceRuleSize로 지정됩니다.

dwInternationalRuleSize

null 종결자를 포함한 국제 전화 걸기 규칙의 크기(바이트)입니다.

dwInternationalRuleOffset

구조체의 시작 부분에서 다른 국가/지역의 번호 호출에 대해 정의된 전화 걸기 규칙까지 오프셋합니다. 규칙은 null로 끝나는 문자열입니다. 필드의 크기는 dwInternationalRuleSize로 지정됩니다.

dwOptions

LINECARDOPTION_ 상수를 사용하여 이 호출 카드 연결된 다른 설정을 나타냅니다.

설명

이전 애플리케이션은 이러한 새 필드를 알지 못하고 새 크기보다 작은 SIZEOF(LINECARDENTRY)를 사용하여 컴파일됩니다. LINETRANSLATECAPS 구조체의 변수 부분에 있는 배열이므로 이전 애플리케이션은 이전에 예상했던 형식으로 LINECARDENTRY 구조를 받거나 배열을 통해 제대로 인덱싱할 수 없습니다. 애플리케이션은 lineGetTranslateCaps 함수를 사용하여 dwAPIVersion 매개 변수를 전달합니다. 이 함수는 이 상황을 처리하는 데 TAPI의 지침에 사용할 수 있습니다. lineGetTranslateCaps 함수는 LINETRANSLATECAPS 구조를 빌드할 때 지정된 API 버전과 일치하는 LINECARDENTRY 필드와 크기를 사용해야 합니다.

이 구조체는 확장되지 않을 수 있습니다.

요구 사항

요구 사항
헤더 tapi.h

추가 정보

LINETRANSLATECAPS

lineGetTranslateCaps