CPI-C 호출
이 섹션에서는 CPI-C(Common Programming Interface for Communications) 호출에 대해 설명합니다. 각 호출에 대해 다음 정보가 제공됩니다.
호출의 가명 및 실제 C 함수 이름입니다.
호출의 정의입니다.
호출에 사용되는 매개 변수 목록 및 각 매개 변수의 데이터 형식입니다. 각 함수의 프로토타입은 WINCPIC에서 선언됩니다. H 파일.
각 입력 및 출력 매개 변수에 대한 설명입니다. 매개 변수 이름은 가명이며 이러한 매개 변수의 실제 이름은 애플리케이션 프로그램에서 선언합니다. 설명에는 매개 변수의 가능한 값이 포함됩니다.
통화는 호출을 실행할 수 있는 상태입니다.
통화에서 반환될 때 대화가 변경될 수 있는 상태입니다. 상태 변경을 일으키지 않는 조건은 기록되지 않습니다. 예를 들어 매개 변수 검사 및 상태 검사로 인해 상태가 변경되지 않습니다.
호출 사용을 설명하는 추가 정보입니다.
데이터 형식
CPI-C에서 제공하고 받은 매개 변수에 대한 데이터 형식은 WINCPIC의 #define 문에 의해 기호 상수로 설정됩니다. H 파일. 예를 들어 CM_INT32 서명된 long int 를 나타내고 CM_PTR far \*를 나타냅니다. 기호 상수를 사용하면 CPI-C 애플리케이션의 이식성이 향상됩니다.
이 참조는 이해하기 쉽게 데이터 형식을 절대( #defined 아님) 용어로 제공합니다.
애플리케이션을 작성할 때 WINCPIC의 기호 상수를 사용해야 합니다. H 파일.
기호 상수
CPI-C에서 제공하고 반환하는 대부분의 매개 변수는 32비트 정수입니다. 코딩을 간소화하기 위해 이러한 매개 변수의 값은 WINCPIC의 #define 문에 의해 설정된 의미 있는 기호 상수로 표시됩니다. H 헤더 파일입니다. 예를 들어 CM_MAPPED_CONVERSATION 값은 정수 1을 나타냅니다. 가독성을 위해 프로그램을 작성할 때 기호 상수만 사용합니다.
문자열
모든 문자열은 CPI-C 인터페이스를 통해 전달될 때 ASCII 형식입니다.
출력 매개 변수의 유효성
CPI-C에서 반환되는 매개 변수는 반환 코드 CM_OK 표시된 대로 CPI-C 호출이 성공적으로 실행된 경우에만 유효합니다.