Compartilhar via

Método IMbnInterface::GetHomeProvider (mbnapi.h)

  • Artigo

Importante

A partir do Windows 10, versão 1803, as APIs do Win32 descritas nesta seção são substituídas pelas APIs Windows Runtime no namespace Windows.Networking.Connectivity.

Obtém o provedor inicial.

Sintaxe

HRESULT GetHomeProvider(
  [out, retval] MBN_PROVIDER *homeProvider
);

Parâmetros

[out, retval] homeProvider

Um ponteiro para uma estrutura MBN_PROVIDER que representa o provedor doméstico. Se esse método retornar qualquer valor diferente de S_OK, esse parâmetro será NULL. Após a conclusão, o aplicativo de chamada deve liberar a memória alocada para os membros providerID e providerName do MBN_PROVIDER chamando SysFreeString

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 O método foi concluído com sucesso. homeProvider contém valores válidos.
E_PENDING
 As informações não estão disponíveis. O serviço de Banda Larga Móvel está atualmente investigando para obter o provedor doméstico. O aplicativo de chamada pode ser notificado quando o provedor inicial está disponível registrando-se para o método OnHomeProviderAvailable de IMbnInterfaceEvents.
E_MBN_PIN_REQUIRED
 O dispositivo requer que um PIN seja inserido para essa operação.
E_MBN_SIM_NOT_INSERTED
 O SIM não está inserido.
E_MBN_BAD_SIM
 Um SIM inválido é inserido no dispositivo.
HRESULT_FROM_WIN32(ERROR_READ_FAULT)
 Não é possível ler a partir da memória do SIM ou do dispositivo. Por exemplo, o SIM não tem informações de provedor doméstico provisionadas.

Comentários

GetHomeProvider retorna as informações do provedor inicial para o dispositivo. O campo dataClass da estrutura MBN_PROVIDER retornada deve ser ignorado.

Para os erros recuperáveis E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED e E_MBN_BAD_SIM, o serviço de Banda Larga Móvel consultará o dispositivo novamente para o provedor doméstico quando a condição de erro terminar. Por exemplo, se o dispositivo exigir que um PIN seja inserido para recuperar essas informações, ele retornará E_MBN_PIN_REQUIRED. Quando o aplicativo insere o PIN para desbloquear o dispositivo, o serviço de Banda Larga Móvel tentará novamente obter essas informações do dispositivo. O sistema atualizará o aplicativo sobre o status de nova consulta chamando o método OnHomeProviderAvailable de IMbnInterfaceEvents.

O método OnHomeProviderAvailable registrado de IMbnInterfaceEvents pode ser chamado quando as informações do provedor doméstico estão disponíveis ou a nova consulta concluída com erro. Depois que essa função retornar êxito, essas informações nunca serão alteradas.

Requisitos

   
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho mbnapi.h

Confira também

IMbnInterface