Estruturas de TSPI

As estruturas de dados usadas pelo TSPI são idênticas às definidas em Estruturas TAPI, com exceção de TUISPICREATEDIALOGINSTANCEPARAMS.

No caso da maioria das estruturas de dados maiores, a responsabilidade pelo preenchimento de membros é dividida entre o provedor de serviços e o TAPI. O provedor de serviços deve preservar os valores presentes nos membros pertencentes ao TAPI. A descrição de quais membros devem ser definidos pelo provedor de serviços e que 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:

• A finalidade da estrutura
• Uma descrição dos valores ou campos
• Uma descrição da extensibilidade da estrutura
• Comentários opcionais sobre como usar a 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 pelo TAPI e pelo provedor de serviços é alocada pelo TAPI ou por um aplicativo usando TAPI. O 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 ficarão disponíveis até que o retorno de chamada de resposta assíncrona indique êxito.

Observação

Algumas estruturas incluem os campos Tamanho e Deslocamento para definir o local 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.