Strutture TSPI

Le strutture di dati usate da TSPI sono identiche a quelle definite in 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 che devono essere impostati dal provider di servizi e che devono essere mantenuti 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 viene richiesto al provider di servizi di aggiungere una stringa ma non è disponibile alcuna stringa, il provider di servizi deve indicare questa condizione in uno dei modi seguenti:

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