Método IMbnConnectionContext::GetProvisionedContexts (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.
Obtém uma lista de contextos de conexão.
Sintaxe
HRESULT GetProvisionedContexts(
[out, retval] SAFEARRAY **provisionedContexts
);
Parâmetros
[out, retval] provisionedContexts
Uma lista de valores de MBN_CONTEXT que representam contextos de conexão armazenados no dispositivo. Em caso de erro, essa matriz é NULL. Quando bem-sucedido, o aplicativo de chamada deve liberar a memória alocada chamando SafeArrayDestroy.
Valor retornado
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
O método foi concluído com sucesso. |
|
Os contextos de conexão não estão disponíveis. O serviço de Banda Larga Móvel está sondando o dispositivo para obter as informações. O aplicativo de chamada pode ser notificado quando os contextos de conexão estão disponíveis registrando-se para o método OnProvisionedContextListChange de IMbnConnectionContextEvents. |
|
Um PIN é necessário para obter os contextos de conexão. |
|
Um SIM não é inserido no dispositivo. |
|
Um SIM inválido é inserido no dispositivo. |
|
O dispositivo não dá suporte à recuperação de contextos provisionados. |
Comentários
Um contexto de conexão é uma abstração de um conjunto específico de parâmetros de configuração de rede para configurar um circuito virtual ou fluxo sobre a conexão física de Banda Larga Móvel na camada 2. No GSM, ele corresponde ao conceito de um contexto PDP; no CDMA, ele corresponde a um perfil de rede.
Em alguns casos, os parâmetros de conexão já estão disponíveis na memória do dispositivo/SIM. Esse método pode ser usado para obter uma lista de contextos de conexão armazenados no dispositivo para a rede atual do provedor doméstico.
Somente contextos do tipo MBN_CONTEXT_TYPE_INTERNET devem ser usados para fazer conexões de dados.
Um dispositivo retornará todos os contextos armazenados para o provedor doméstico atual. Alguns dos contextos podem estar vazios e serão relatados como MBN_CONTEXT_TYPE_NONE.
Às vezes, os contextos provisionados armazenados podem ser atualizados pela rede por meio de SMS ou OTA. Sempre que houver uma alteração nos contextos provisionados pelo dispositivo, o serviço de Banda Larga Móvel chamará o método OnProvisionedContextListChange de IMbnConnectionContextEvents. Um aplicativo pode usar esse método para obter a lista atualizada de contextos provisionados.
Para os erros recuperáveis E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED e E_MBN_BAD_SIM, o serviço de Banda Larga Móvel consultará o dispositivo novamente para obter essas informações quando a condição de erro terminar. Por exemplo, se o dispositivo exigir que um PIN fosse inserido para recuperar os contextos de conexão, ele retornará E_MBN_PIN_REQUIRED. Quando o aplicativo insere um PIN para desbloquear o dispositivo, o serviço tentará novamente obter essas informações do dispositivo. O serviço atualizará o aplicativo sobre o status da nova consulta chamando o método OnProvisionedContextListChange de IMbnConnectionContextEvents.
Requisitos
| 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 |