Método IMbnMultiCarrier::SetHomeProvider (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.
Atualizações o provedor inicial de um dispositivo de várias operadoras.
Sintaxe
HRESULT SetHomeProvider(
[in] MBN_PROVIDER2 *homeProvider,
[out] ULONG *requestID
);
Parâmetros
[in] homeProvider
Uma estrutura MBN_PROVIDER2 que contém o provedor doméstico.
Os membros SignalStrength e SignalError devem ser 0.
[out] requestID
Um ponteiro para a ID de solicitação definida pelo sistema operacional para essa solicitação. A resposta assíncrona de OnSetHomeProviderComplete conterá essa mesma requestID.
Ponteiro para a ID de solicitação definida pelo sistema operacional para essa solicitação. A resposta assíncrona conterá essa mesma requestID.
Valor retornado
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
O método foi concluído com sucesso. |
|
O serviço de Banda Larga Móvel não está em execução neste sistema. |
|
Interface inválida. O dispositivo de Banda Larga Móvel provavelmente foi removido do sistema. |
|
Interface inválida. Provavelmente, o dispositivo de Banda Larga Móvel foi removido do sistema. |
|
A operação não é compatível com o dispositivo. Isso pode ser retornado por dispositivos que não dão suporte a várias operadoras. |
Comentários
O método SetHomeProvider inicia uma atualização do provedor inicial para a interface. Essa é uma operação assíncrona e a chamada de método retorna imediatamente. Se esse método retornar com êxito com S_OK, o Windows notificará o aplicativo de chamada sobre o status de conclusão dessa operação chamando o método OnSetHomeProviderComplete de IMbnMultiCarrierEvents.
Em seguida, o dispositivo será automaticamente registrado na nova rede e indicará uma alteração de estado de registro. O dispositivo continuará sendo registrado para essa nova rede inicial em reinicializações do Windows, a menos que SetHomeProvider seja usado novamente para definir um novo provedor doméstico.
Se o dispositivo for removido do sistema antes da conclusão desta operação, não haverá garantia de que a notificação de conclusão será recebida pelo aplicativo de chamada.
Requisitos
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | mbnapi.h |