Strutture TSPI

Le strutture di dati usate da TSPI sono identiche a quelle definite nelle strutture TAPI, ad eccezione di TUISPICREATEDIALOGINSTANCEPARAMS.

Nel caso della maggior parte delle strutture di dati più grandi, la responsabilità di compilare i membri è divisa tra il provider di servizi e TAPI. Il provider di servizi deve mantenere i valori presenti nei membri di proprietà di TAPI. La descrizione dei membri da impostare dal provider di servizi e che deve essere mantenuta viene fornita nella sezione Funzioni nelle funzioni che fanno riferimento a tale struttura di dati.

Per ogni struttura, la sezione di riferimento elenca gli elementi seguenti:

• Scopo della struttura
• Descrizione dei valori o dei campi
• Descrizione dell'estendibilità della struttura
• Commenti facoltativi sull'uso della struttura
• Riferimenti facoltativi ad altre funzioni, messaggi, costanti o strutture.

Memoria per tutte le strutture di dati la cui rappresentazione viene pubblicata e condivisa sia da TAPI che dal provider di servizi viene allocata da TAPI o da un'applicazione tramite TAPI. TAPI passa un puntatore alla funzione TSPI che restituisce le informazioni. TSPI riempie la struttura dei dati con le informazioni richieste. Se l'operazione è asincrona, le informazioni non sono disponibili finché il callback di risposta asincrona non indica l'esito positivo.

Nota

Alcune strutture includono i campi Size e Offset per definire la posizione e la lunghezza delle stringhe nella parte variabile della struttura. Se il provider di servizi è richiesto di aggiungere una stringa ma non è disponibile alcuna stringa, il provider di servizi deve indicare questa condizione in uno dei modi seguenti:

• Impostare entrambi i campi Dimensioni e Offset su 0.
• Impostare il campo Offset su diverso da zero, ma su Size su 0.
• Impostare il campo Offset su diverso da zero, Size su 1 e il byte in corrispondenza dell'offset su 0.