Struktur TSPI

Struktur data yang digunakan TSPI identik dengan yang didefinisikan dalam Struktur TAPI, dengan pengecualian TUISPICREATEDIALOGINSTANCEPARAMS.

Dalam kasus sebagian besar struktur data yang lebih besar, tanggung jawab untuk mengisi anggota dibagi antara penyedia layanan dan TAPI. Penyedia layanan harus mempertahankan nilai yang ada di anggota yang dimiliki oleh TAPI. Deskripsi anggota mana yang harus ditetapkan oleh penyedia layanan dan yang harus dipertahankan disediakan di bagian Fungsi dalam fungsi yang merujuk ke struktur data tersebut.

Untuk setiap struktur, bagian referensi mencantumkan item berikut:

• Tujuan struktur
• Deskripsi nilai atau bidang
• Deskripsi ekstensibilitas struktur
• Komentar opsional tentang menggunakan struktur
• Referensi opsional ke fungsi, pesan, konstanta, atau struktur lainnya.

Memori untuk semua struktur data yang representasinya diterbitkan dan dibagikan oleh TAPI dan penyedia layanan dialokasikan oleh TAPI atau aplikasi menggunakan TAPI. TAPI meneruskan penunjuk ke fungsi TSPI yang mengembalikan informasi. TSPI mengisi struktur data dengan informasi yang diminta. Jika operasi tidak sinkron, informasi tidak tersedia sampai panggilan balik balasan asinkron menunjukkan keberhasilan.

Nota

Beberapa struktur termasuk bidang Ukuran dan Offset untuk menentukan lokasi dan panjang string dalam bagian variabel struktur. Jika penyedia layanan diminta untuk menambahkan string tetapi tidak ada string yang tersedia, penyedia layanan harus menunjukkan kondisi ini dengan salah satu cara berikut:

• Atur bidang Ukuran dan Offset ke 0.
• Atur bidang Offset ke bukan nol tetapi Ukuran ke 0.
• Atur bidang Offset ke nonzero, Ukuran ke 1, dan byte di Offset ke 0.