Método IMbnRegistration::GetProviderID (mbnapi.h)

Obtém a ID do provedor para a rede registrada no momento.

Sintaxe

HRESULT GetProviderID(
  [out] BSTR *providerID
);

Parâmetros

[out] providerID

Ponteiro para uma cadeia de caracteres que contém a ID do provedor registrado no momento. O comprimento máximo é MBN_PROVIDERID_LEN caracteres. A cadeia de caracteres é preenchida somente quando o método retorna S_OK para êxito. Após o sucesso, o aplicativo de chamada deve liberar a memória alocada chamando SysFreeString.

Valor retornado

Esse método pode retornar um desses valores.

Comentários

O método GetProviderID obtém a ID do provedor registrado no momento. Para o modo de seleção de rede automática, essa é a ID da rede à qual o dispositivo está registrado no momento. Se o modo de seleção de rede for manual, esse campo conterá a ID do provedor da rede à qual o dispositivo tentará se registrar. Para dispositivos CDMA, ele será definido como MBN_CDMA_DEFAULT_PROVIDER_ID se a ID do provedor não for conhecida.

Essas informações podem ser alteradas quando o dispositivo de Banda Larga Móvel passa de uma rede para outra. Isso inclui sempre que há uma alteração de MBN_REGISTER_STATE_HOME para MBN_REGISTER_STATE_SEARCHING no estado de registro de rede. Isso também ocorre quando há uma alteração na rede registrada, como quando uma rede move seu registro de um provedor para outro. Após essas alterações, o serviço de Banda Larga Móvel chamará o método OnRegisterStateChange de IMbnRegistrationEvents. Quando isso acontece, o aplicativo deve chamar GetProviderID.

Para o erro recuperável E_MBN_PIN_REQUIRED, o serviço de Banda Larga Móvel tentará buscar novamente essas informações do dispositivo quando a condição de erro terminar (quando um PIN for inserido). Posteriormente, o serviço de Banda Larga Móvel chamará o método OnPacketServiceStateChange de IMbnRegistrationEvents.

Requisitos

Confira também

IMbnRegistration