Função lineAgentSpecific (tapi.h)

Artigo
03/08/2023

A função lineAgentSpecific permite que o aplicativo acesse funções específicas do manipulador proprietário do manipulador de agente associado ao endereço. O significado das extensões é específico para o manipulador do agente. Cada conjunto de extensões relacionadas ao agente é identificado por uma ID de extensão de 128 bits universalmente exclusiva que deve ser obtida, juntamente com a especificação da extensão, do promulgador dessa extensão (geralmente o autor do software manipulador de agente no servidor de telefonia). A lista de extensões com suporte pelo manipulador de agente é obtida da estrutura LINEAGENTCAPS retornada por lineGetAgentCaps.

Sintaxe

LONG lineAgentSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  DWORD  dwAgentExtensionIDIndex,
  LPVOID lpParams,
  DWORD  dwSize
);

Parâmetros

hLine

Manipule para o dispositivo de linha aberta.

dwAddressID

Endereço no dispositivo de linha aberta. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante entre as atualizações do sistema operacional.

dwAgentExtensionIDIndex

Posição na estrutura ExtensionIDList em LINEAGENTCAPS da extensão do manipulador de agente que está sendo invocada.

lpParams

Ponteiro para uma área de memória usada para manter um bloco de parâmetros. O formato desse bloco de parâmetro é específico do dispositivo e seu conteúdo é passado por TAPI de e para o aplicativo manipulador de agente no servidor de telefonia. Esse bloco de parâmetros deve especificar a função a ser invocada e incluir espaço suficiente para que todos os dados sejam retornados.

dwSize

Tamanho da área do bloco de parâmetros, em bytes.

Nota Se lpParams for um ponteiro para uma cadeia de caracteres, o tamanho deverá incluir o terminador NULL .

Retornar valor

Retorna um identificador de solicitação positivo se a operação assíncrona for iniciada; caso contrário, essa função retornará um destes valores de erro negativos:

LINEERR_INVALADDRESSID, LINEERR_INVALAGENTID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Valores retornados adicionais são específicos para o manipulador do agente.

Comentários

Essa operação faz parte dos serviços de telefonia estendida. Ele fornece acesso a um recurso específico do manipulador de agente sem definir seu significado.

Essa função fornece um perfil de parâmetro genérico. A interpretação da estrutura de parâmetros é específica do manipulador. As indicações e respostas enviadas de volta ao aplicativo que são específicas do manipulador devem usar a mensagem LINE_AGENTSPECIFIC .

Um manipulador de agente pode fornecer acesso a funções específicas do manipulador definindo parâmetros para uso com essa função. Os aplicativos que desejam usar essas extensões devem consultar a documentação específica do fornecedor que descreve quais extensões são definidas. Normalmente, um aplicativo que depende dessas extensões não é capaz de trabalhar com outros ambientes de manipulador de agente.