lineRegister

9/19/2008

Use o lineRegister função para registrar um dispositivo com um operador rede particular.

Syntax

LONG WINAPI lineRegister(
  HLINE hLine,
  DWORD dwRegisterMode,
    LPCTSTR lpszOperator,
  DWORD dwOperatorFormat
);

Parameters

• hLine
  Identificador de dispositivo de linha. Identificador de dispositivo de linha deve ter sido anteriormente obtido por um chamar para lineOpen Com o dispositivo apropriado TAPI identificação especificada e uma versão extensão Device-specific negociado com êxito com lineNegotiateExtVersion.

• dwRegisterMode
  Identifica o modo de registro. Valores possíveis são listados na seguinte tabela.

  Valor	Descrição
  LINEREGMODE_AUTOMATIC	Automaticamente registrar com disponível operador.
  LINEREGMODE_MANUAL	Explicitamente registrar com um operador específico.
  LINEREGMODE_MANAUTO	Se registro manual falhar, registrar automaticamente.

• lpszOperator
  Um seqüência de caracteres que identifica o operador para registrar com. Este parâmetro é ignorado e opcional se dwRegisterMode é LINEREGMODE_AUTOMATIC.

• dwOperatorFormat
  Identifica o formato de lpszOperator. Este parâmetro é ignorado e opcional se dwRegisterMode é LINEREGMODE_AUTOMATIC. Valores possíveis são listados na seguinte tabela.

  Valor	Descrição
  LINEOPFORMAT_NONE	O lpszOperator campo é não usado.
  LINEOPFORMAT_ALPHASHORT	Descrição de texto curto.
  LINEOPFORMAT_ALPHALONG	Descrição de texto longo.
  LINEOPFORMAT_NUMERIC	Descrição numérica.

Return Value

Retorna um identificador positivo solicitação se a função for de forma assíncrona concluída, ou um número negativo erro se ocorrer um erro. O dwParam2 parâmetro do correspondente mensagem LINE_REPLY será zero se a função é bem-sucedida ou é um número negativo erro se ocorrer um erro. Para obter mais detalhes, consulte modelo síncrono ou assíncrono TAPI em MicrosoftMSDN on-line. O seguinte é valores de retorno possíveis:

• LINEERR_INVALLINEHANDLE
• LINEERR_NOMEM
• LINEERR_OPERATIONUNAVAIL
• LINEERR_OPERATIONFAILED
• LINEERR_RESOURCEUNAVAIL
• LINEERR_INVALPOINTER
• LINEERR_INVALPARAM
• LINEERR_UNINITIALIZED

Remarks

Quando explicitamente registrando com um operador específico, o usuário deve presumir que o nome operador é com diferenciação de maiúsculas e minúsculas. Não implementado para CDMA.

Essa é uma função com privilégios.

Requirements

Header	extapi.h
Library	cellcore.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

Extended TAPI Functions