estrutura MBN_INTERFACE_CAPS (mbnapi.h)

A estrutura MBN_INTERFACE_CAPS representa os recursos de interface. Essa estrutura é retornada pelo método GetInterfaceCapability de IMbnInterface.

Sintaxe

typedef struct MBN_INTERFACE_CAPS {
  MBN_CELLULAR_CLASS cellularClass;
  MBN_VOICE_CLASS    voiceClass;
  ULONG              dataClass;
  BSTR               customDataClass;
  ULONG              gsmBandClass;
  ULONG              cdmaBandClass;
  BSTR               customBandClass;
  ULONG              smsCaps;
  ULONG              controlCaps;
  BSTR               deviceID;
  BSTR               manufacturer;
  BSTR               model;
  BSTR               firmwareInfo;
} MBN_INTERFACE_CAPS;

Membros

cellularClass

Um valor MBN_CELLULAR_CLASS que especifica a tecnologia da rede celular usada pelo dispositivo.

voiceClass

Um valor MBN_VOICE_CLASS que especifica como as chamadas de voz são tratadas.

dataClass

Uma combinação OR bit a bit de valores MBN_DATA_CLASS que especifica quais serviços de dados têm suporte. Para dispositivos GSM, somente os serviços de dados baseados em GSM podem estar presentes, ou seja, somente GPRS, EDGE, UMTS, LTE e HSDPA são valores válidos para dispositivos GSM.

Para dispositivos CDMA, somente os serviços de dados relacionados ao CDMA estarão presentes, ou seja, apenas 1xRTT, 1xEV-DO e 1xEV-DO RevA são valores válidos para dispositivos CDMA. O RevB 1xEV-DO é reservado para uso futuro.

Esse campo tem o valor de bit MBN_DATA_CLASS_CUSTOM definido se a classe de dados alguma outra classe de dados que não está definida na enumeração também é compatível com o dispositivo. Se MBN_DATA_CLASS_CUSTOM estiver definido, as informações sobre a classe de dados personalizada estão disponíveis no campo customDataClass .

customDataClass

Contém o nome da classe de dados personalizada. Se o MBN_DATA_CLASS_CUSTOM bit de dataClass não estiver definido, a cadeia de caracteres será NULL. Caso contrário, o chamador deve liberar essa cadeia de caracteres chamando SysFreeString.

gsmBandClass

Um campo de bits que especifica as faixas de frequência compatíveis com o dispositivo GSM. MBN_BAND_CLASS_I por meio de MBN_BAND_CLASS_X e MBN_BAND_CLASS_CUSTOM são valores válidos. Esses valores são definidos por MBN_BAND_CLASS. Se gsmBandClass estiver definido como MBN_BAND_CLASS_CUSTOM, informações adicionais sobre a classe de banda aparecerão em customBandClass.

A tabela a seguir fornece informações adicionais sobre os valores MBN_BAND_CLASS .

cdmaBandClass

Um campo de bits que especifica as faixas de frequência compatíveis com o dispositivo CDMA. MBN_BAND_CLASS_0 por meio de MBN_BAND_CLASS_XVII, MBN_BAND_CLASS_NONE e MBN_BAND_CLASS_CUSTOM são valores válidos. Esses valores são definidos por MBN_BAND_CLASS. Se cdmaBandClass estiver definido como MBN_BAND_CLASS_CUSTOM, informações adicionais sobre a classe de banda aparecerão em customBandClass.

A tabela a seguir fornece informações adicionais sobre MBN_BAND_CLASS valores.

customBandClass

Contém o nome da classe de banda personalizada. Se o MBN_BAND_CLASS_CUSTOM bit de cdmaBandClass e gsmBandClass não estiver definido, a cadeia de caracteres será NULL. Caso contrário, o chamador deve liberar essa cadeia de caracteres chamando SysFreeString.

smsCaps

Uma combinação OR bit a bit de valores de MBN_SMS_CAPS que especifica os recursos de SMS.

controlCaps

Uma combinação OR bit a bit de valores de MBN_CTRL_CAPS que representa os recursos de controle de Banda Larga Móvel para essa interface.

deviceID

Contém a ID do dispositivo. Para dispositivos GSM, esse deve ser o IMEI (até 15 dígitos). Para dispositivos CDMA, esse deve ser o ESN (11 dígitos) /MEID (17 dígitos). O comprimento máximo da cadeia de caracteres é MBN_DEVICEID_LEN. Para obter a definição de MBN_DEVICEID_LEN, consulte MBN_INTERFACE_CAPS_CONSTANTS. O chamador deve liberar essa cadeia de caracteres chamando SysFreeString.

manufacturer

Contém o nome do fabricante do dispositivo. Essa cadeia de caracteres pode estar vazia. O comprimento máximo da cadeia de caracteres é MBN_MANUFACTURER_LEN. Para obter a definição de MBN_MANUFACTURER_LEN, consulte MBN_INTERFACE_CAPS_CONSTANTS. O chamador deve liberar essa cadeia de caracteres chamando SysFreeString.

model

Contém o modelo de dispositivo. Essa cadeia de caracteres pode estar vazia. O comprimento máximo dessa cadeia de caracteres é MBN_MODEL_LEN. Para obter a definição de MBN_MODEL_LEN, consulte MBN_INTERFACE_CAPS_CONSTANTS. O chamador deve liberar essa cadeia de caracteres chamando SysFreeString.

firmwareInfo

Contém as informações específicas do firmware para este dispositivo. Essa cadeia de caracteres pode estar vazia. O comprimento máximo da cadeia de caracteres é MBN_FIRMWARE_LEN. Para obter a definição de MBN_FIRMWARE_LEN, consulte MBN_INTERFACE_CAPS_CONSTANTS. O chamador deve liberar essa cadeia de caracteres chamando SysFreeString.

Requisitos