Método IMbnRegistration::GetCurrentDataClass (mbnapi.h)
Importante
A partir de 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 a classe de dados atual na rede atual.
Sintaxe
HRESULT GetCurrentDataClass(
[out] ULONG *currentDataClass
);
Parâmetros
[out] currentDataClass
Um ponteiro para um valor MBN_DATA_CLASS . Esse parâmetro só será significativo se a função retornar S_OK.
Retornar valor
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
A operação foi bem-sucedida. |
|
As classes de dados não estão disponíveis. no momento, o serviço de Banda Larga Móvel está investigando o dispositivo para obter as informações. Quando as classes de dados estiverem disponíveis, o serviço de Banda Larga Móvel chamará o método OnPacketServiceStateChange de IMbnRegistrationEvents. |
|
Um PIN é necessário para obter as classes de dados. |
|
Um SIM não é inserido no dispositivo. |
|
Um SIM incorreto é inserido no dispositivo. |
Comentários
O método GetCurrentDataClass retorna a classe de dados na rede atual. Esse valor pode ser definido como MBN_DATA_CLASS_NONE se o valor não for conhecido.
A classe de dados atual pode ser alterada automaticamente à medida que um dispositivo passa de uma rede celular para outra. Sempre que essa alteração ocorrer, o serviço de Banda Larga Móvel notificará os aplicativos chamando o método OnPacketServiceStateChange de IMbnRegistrationEvents.
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
| Requisito | Valor |
|---|---|
| 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 |