Compartilhar via

Método IMbnConnectionContextEvents::OnSetProvisionedContextComplete (mbnapi.h)

  • Artigo

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.

Método de notificação chamado pelo serviço de Banda Larga Móvel para indicar que o contexto provisionado no dispositivo foi definido.

Sintaxe

HRESULT OnSetProvisionedContextComplete(
  [in] IMbnConnectionContext *newInterface,
  [in] ULONG                 requestID,
  [in] HRESULT               status
);

Parâmetros

[in] newInterface

Uma interface IMbnConnectionContext que representa o dispositivo para o qual o contexto foi definido.

[in] requestID

Uma ID de solicitação definida pelo serviço de Banda Larga Móvel para identificar a operação que define o contexto.

[in] status

Um código status que indica o resultado da operação.

Um aplicativo de chamada pode esperar um dos valores a seguir.

Valor Significado
S_OK
 A operação foi bem-sucedida.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 O dispositivo não dá suporte a essa operação.
E_MBN_PIN_REQUIRED
 Um PIN é necessário para que a operação seja concluída.
E_INVALIDARG
 A ID de contexto ou a ID do provedor fornecida na solicitação não é válida.
E_MBN_BAD_SIM
 Há um SIM inválido no dispositivo.
HRESULT_FROM_WIN32(ERROR_WRITE_FAULT)
 Falha em uma atualização na memória do DISPOSITIVO ou SIM.

Retornar valor

Esse método deve retornar S_OK.

Comentários

Um aplicativo de chamada pode passar uma interface IMbnConnectionContext para newInterface para obter a lista atualizada de contextos provisionados no dispositivo. No entanto, como essa operação é assíncrona, o aplicativo deve aguardar a notificação OnProvisionedContextListChange antes de usar essa interface para obter os contextos.

Se houver vários aplicativos registrados para receber notificações, todos eles receberão essa notificação, mesmo que apenas um deles possa ter iniciado essa operação.

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

Confira também

IMbnConnectionContextEvents