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 de preencher membros é dividida entre o provedor de serviços e o TAPI. O provedor 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 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 de todas as estruturas de dados cuja representação é publicada e compartilhada pelo TAPI e pelo provedor de serviços é alocada pela 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íncrono indique êxito.

Nota

Algumas estruturas incluem 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.

 

 

 

  • Last updated on