Compartilhar via


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
S_OK
A operação foi bem-sucedida.
E_PENDING
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.
E_MBN_PIN_REQUIRED
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

Confira também

IMbnRegistration