Estruturas TSPI

As estruturas de dados que o TSPI usa são idênticas às definidas em TAPI Structures, com exceção de TUISPICREATEDIALOGINSTANCEPARAMS.

No caso da maioria das estruturas de dados maiores, a responsabilidade pelo preenchimento dos membros é dividida entre o prestador de serviços e a TAPI. O prestador de serviços deve preservar os valores presentes nos membros pertencentes à TAPI. A descrição de quais membros devem ser definidos pelo provedor de serviços e quais devem ser preservados é fornecida na seção Funções nas funções que se referem a essa estrutura de dados.

Para cada estrutura, a seção de referência lista os seguintes itens:

• O objetivo da estrutura
• Uma descrição dos valores ou campos
• Descrição da extensibilidade da estrutura
• Comentários opcionais sobre o uso da estrutura
• Referências opcionais a outras funções, mensagens, constantes ou estruturas.

A memória para todas as estruturas de dados cuja representação é publicada e compartilhada pela TAPI e pelo provedor de serviços é alocada pela TAPI ou por um aplicativo usando TAPI. TAPI passa um ponteiro para a função TSPI que retorna as informações. O TSPI preenche a estrutura de dados com as informações solicitadas. Se a operação for assíncrona, as informações não estarão disponíveis até que o retorno de chamada de resposta assíncrona indique sucesso.

Observação

Algumas estruturas incluem campos Tamanho e Deslocamento para definir a localização e o comprimento das cadeias de caracteres na parte variável da estrutura. Se o provedor de serviços for solicitado a adicionar uma cadeia de caracteres, mas nenhuma cadeia de caracteres estiver disponível, o provedor de serviços deverá indicar essa condição de uma destas maneiras:

• Defina os campos Tamanho e Deslocamento como 0.
• Defina o campo Deslocamento como diferente de zero, mas Tamanho como 0.
• Defina o campo Deslocamento como diferente de zero, Tamanho como 1 e o byte no Deslocamento como 0.