TSPI 구조체
TSPI에서 사용하는 데이터 구조는 TUISPICREATEDIALOGINSTANCEPARAMS를 제외하고 TAPI 구조에 정의된 것과 동일합니다.
대부분의 대규모 데이터 구조의 경우 멤버를 채우는 책임은 서비스 공급자와 TAPI로 나뉩니다. 서비스 공급자는 TAPI가 소유한 멤버에 있는 값을 유지해야 합니다. 서비스 공급자가 설정해야 하는 멤버와 보존해야 하는 멤버에 대한 설명은 해당 데이터 구조를 참조하는 함수의 Functions 섹션에 제공됩니다.
각 구조에 대해 참조 섹션에는 다음 항목이 나열됩니다.
- 구조체의 목적
- 값 또는 필드에 대한 설명
- 구조체의 확장성에 대한 설명
- 구조체 사용에 대한 선택적 주석
- 다른 함수, 메시지, 상수 또는 구조체에 대한 선택적 참조입니다.
TAPI와 서비스 공급자가 표현을 게시하고 공유하는 모든 데이터 구조에 대한 메모리는 TAPI 또는 TAPI를 사용하는 애플리케이션에서 할당됩니다. TAPI는 정보를 반환하는 TSPI 함수에 포인터를 전달합니다. TSPI는 요청된 정보로 데이터 구조를 채웁니다. 작업이 비동기인 경우 비동기 회신 콜백이 성공을 나타내기 전까지는 정보를 사용할 수 없습니다.
참고
일부 구조체에는 구조체의 변수 부분에서 문자열의 위치 및 길이를 정의하기 위한 크기 및 오프셋 필드가 포함됩니다. 서비스 공급자가 문자열을 추가하도록 요청되었지만 문자열을 사용할 수 없는 경우 서비스 공급자는 다음 방법 중 하나로 이 조건을 나타내야 합니다.
- 크기 및 오프셋 필드를 모두 0으로 설정합니다.
- 오프셋 필드를 0이 아닌 크기로 설정합니다.
- 오프셋 필드를 0이 아닌 값으로, 크기를 1로, 오프셋의 바이트를 0으로 설정합니다.