Método IMbnInterface::GetHomeProvider (mbnapi.h)
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 |
|---|---|
|
O método foi concluído com sucesso. homeProvider contém valores válidos. |
|
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. |
|
O dispositivo requer que um PIN seja inserido para essa operação. |
|
O SIM não está inserido. |
|
Um SIM inválido é inserido no dispositivo. |
|
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 |