Método IMbnRegistration::GetAvailableDataClasses (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 as classes de dados disponíveis na rede atual.
Sintaxe
HRESULT GetAvailableDataClasses(
[out] ULONG *availableDataClasses
);
Parâmetros
[out] availableDataClasses
Um ponteiro para uma combinação OR bit a bit de valores de 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. |
Comentários
GetAvailableDataClasses retorna o conjunto de classe de dados possível na rede atual. Esses valores podem ser definidos como MBN_DATA_CLASS_NONE se o valor não for conhecido.
As classes de dados disponíveis podem ser alteradas automaticamente à medida que um dispositivo passa de uma célula 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 |