Verificação de erros

No nível TAPI, um aplicativo pode passar uma variedade de parâmetros diferentes, muitos dos quais podem ser inválidos. A TAPI verifica parâmetros e retorna erros para o aplicativo sem chamar o provedor de serviços. Cada descrição de função no nível TSPI descreve os erros de parâmetro já testados. O prestador de serviços não tem de repetir estes testes, embora deva realizar quaisquer testes de validade adicionais adequados à função. Os títulos e descrições dos testes de validade de parâmetros comuns que aparecem em muitas funções estão listados na tabela a seguir.

Teste de validade Descrição
Validade do ponteiro A TAPI já testou ponteiros para o armazenamento de dados para garantir que eles apontem para uma memória legível ou gravável do tamanho adequado à operação. Além disso, para estruturas de dados de tamanho variável começando com um membro dwTotalSize, a estrutura de dados foi verificada para garantir que o tamanho total indicado esteja disponível.
Validade de tamanho fixo Para estruturas de dados de tamanho variável, a estrutura de dados foi verificada de modo que o espaço para a parte de tamanho fixo da estrutura de dados e que dwTotalSize seja suficiente para a parte fixa.
Deslocamento/tamanho zerado Para estruturas de dados de tamanho variável, os campos "...Deslocamento" e "...Tamanho" que correspondem a partes que o provedor de serviços define foram predefinidas com valores zero antes de o provedor de serviços ser chamado.
Validade do identificador A TAPI garante que os identificadores de linha, telefone e chamada (de tipos definidos HDRVLINE, HDRVPHONEe HDRVCALL) sejam válidos. Ou seja, são valores que foram retornados sem erro como identificadores em TSPI_lineOpen, TSPI_phoneOpenou um dos seguintes que inicia o tempo de vida de um identificador de chamada: TSPI_lineMakeCall
TSPI_lineCompleteTransfer
TSPI_lineForward
TSPI_linePickup
TSPI_linePrepareAddToConference
TSPI_lineSetupConference
TSPI_lineSetupTransfer
TSPI_lineUnpark
LINE_NEWCALL mensagens