Método IMbnRadio::SetSoftwareRadioState (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.
Define o estado de rádio de software de um dispositivo de banda larga móvel.
Sintaxe
HRESULT SetSoftwareRadioState(
[in] MBN_RADIO radioState,
[out] ULONG *requestID
);
Parâmetros
[in] radioState
Um valor MBN_RADIO que especifica o novo estado de rádio de software.
[out] requestID
Um ponteiro para uma ID de solicitação atribuída pelo serviço de Banda Larga Móvel para identificar essa solicitação.
Retornar valor
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
A operação foi bem-sucedida. |
|
A interface é inválida. Provavelmente, o dispositivo de Banda Larga Móvel foi removido do sistema. |
|
A interface é inválida. Provavelmente, o dispositivo de Banda Larga Móvel foi removido do sistema. |
|
O serviço de Banda Larga Móvel não está em execução neste sistema. |
Comentários
SetSoftwareRadioState altera o estado de rádio de software do dispositivo. Essa é uma operação assíncrona e retornará imediatamente. Após a conclusão, o serviço de Banda Larga Móvel chamará o método OnSetSoftwareRadioStateComplete da interface IMbnRadioEvents .
Desabilitar o rádio para um dispositivo de Banda Larga Móvel resultará na desativação de qualquer conexão ativa, desanexação de pacotes de rede e cancelamento do registro de rede. Se a operação de desativação de rádio resultar em uma alteração no estado de conexão, no estado de anexação de pacote ou no estado de registro de rede, o aplicativo receberá uma notificação das alterações.
Quando o software e o rádio de hardware estiverem habilitados para um dispositivo de Banda Larga Móvel, ele tentará se registrar automaticamente na rede. Além disso, alguns dispositivos também podem tentar executar a anexação de pacote à rede. Sempre que o estado for alterado, o aplicativo de chamada receberá notificações de evento para o registro de rede e alterações de estado de anexação de pacote.
O estado de rádio de um dispositivo pode ser alterado sem uma solicitação de alteração do aplicativo. Por exemplo, se um usuário ativar o comutador de rádio de hardware do sistema. O serviço de Banda Larga Móvel notificará o aplicativo sobre uma alteração no estado de rádio chamando o método OnRadioStateChange da interface IMbnRadioEvents .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | mbnapi.h |