lineGetGeneralInfo
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/19/2008
Use o lineGetGeneralInfo função para recuperar informações dispositivo gerais sobre o hardware de rádio, o software de rádio, a serial número, identidade assinante e outras informações.
Syntax
LONG WINAPI lineGetGeneralInfo(
HLINE hLine,
LPLINEGENERALINFO lpLineGeneralInfo
);
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.
- lpLineGeneralInfo
Aponta para um LINEGENERALINFO estrutura que fornece informações sobre o fabricante módulo de rádio, número versão e outras informações.
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
.gif "Aa921871.collapse(pt-br,MSDN.10).gif")
Para todas as plataformas
Essa função é síncrono. Nenhuma mensagem LINE_REPLY é enviada. Quando lineGetGeneralInfo é executado, chamadas TAPI RIL_GetEquipmentInfoe, em seguida, RIL_GetUserIdentity. Nem RIL_GetEquipmentInfo Nem RIL_GetUserIdentity Retorna o número assinante. Para get o número assinante para dispositivos GSM e CDMA, use a função lineGetAddressID.
O suporte para esta função varia em dispositivos CDMA. Para lineGetGeneralInfo Para completo com êxito em um dispositivo, driver RIL de dispositivo CDMA deve suporte a RIL_GetUserIdentity e RIL_GetEquipmentInfo funções.
Esta função pode ser usada para recuperar a Electronic Serial Number (ESN) de um dispositivo CDMA. Normalmente, o ESN é parte de LINEGENERALINFO estrutura e é representada como um hexadecimal dígito oito número começando a dwSerialNumberOffset.
Para Windows incorporado CE
Para obter mais informações sobre as funções RIL, consulte RIL_GetUserIdentity e RIL_GetEquipmentInfo.
Para Mobile Windows
Essa é uma função com privilégios. Para obter mais informações sobre segurança Windows Mobile 6 Standard e APIs privilegiado, consulte o "segurança Brazilian OS" Tópico de Windows Mobile adaptação Kit.
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 |