lineGetOperatorStatus

9/19/2008

Use o lineGetOperatorStatus função para recuperar as listas de preferencial e disponível operadores. A lista operador preferido é armazenada localmente no dispositivo e registro automático itera através esta lista ao tentar registrar. O disponível lista mostra quais operadores rede estão atualmente no intervalo do dispositivo. Para obter o atual operador, use lineGetCurrentOperator.

Syntax

LONG WINAPI lineGetOperatorStatus(
  HLINE hLine,
  LPLINEOPERATORSTATUS lpOperatorStatus
);

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.

• lpOperatorStatus
  Aponta para um estrutura de dados variably tamanho do tipo LINEOPERATORSTATUS. Veja a seção LINEOPERATOR estrutura para valores possíveis.

Return Value

Retorna zero se a função for concluído com êxito, ou um número negativo erro se ocorrer um erro. O seguinte é valores de retorno possíveis:

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

Remarks

Prior to chamado primeiro lineGetOperatorStatus, o aplicativo deve definir a dwTotalSize membro das LINEOPERATORSTATUS estrutura passado como o lpOperatorStatus parâmetro para 0 (zero). Isso irá retornar o tamanho, em bytes de memória necessária para armazenar os dados retornados por subseqüentemente chamado essa função.

Essa função é síncrono. Nenhuma mensagem LINE_REPLY é enviada e o aplicativo pode usar o conteúdo das estruturas parâmetro imediatamente após essa função retorna. Não implementado para CDMA.

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
lineGetCurrentOperator
LINEOPERATOR
LINEOPERATORSTATUS