lineSetPreferredOperator

9/19/2008

Use o lineSetPreferredOperator função para definir ou excluir um operador preferido. A lista operador preferido é armazenada localmente no telefone e registro automático itera através esta lista ao tentar registrar.

Syntax

LONG WINAPI lineSetPreferredOperator(
  HLINE hLine,
  LPLINEOPERATOR lpOperator
);

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.

• lpOperator
  Aponta para um LINEOPERATOR estrutura que fornece informações sobre um operador preferido. Se a pasta dwIndex membro for LINEOPERATOR_USEFIRSTAVAILABLEINDEX, gravar primeiro disponível localidade. Se dwValidParams é LINEOPFORMAT_NONE e dwIndex Não é LINEOPERATOR_USEFIRSTAVAILABLEINDEX, apague a entrada operador em dwIndex.

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. O seguinte é valores de retorno possíveis:

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

Remarks

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

Não implementado para CDMA.

Observação

Para seleção operador, use o ID. numérico

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
LINEOPERATOR