Compartilhar via

Método IMbnConnectionContext::SetProvisionedContext (mbnapi.h)

  • Artigo

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.

Adiciona ou atualiza um contexto provisionado.

Sintaxe

HRESULT SetProvisionedContext(
  [in]  MBN_CONTEXT provisionedContexts,
  [in]  LPCWSTR     providerID,
  [out] ULONG       *requestID
);

Parâmetros

[in] provisionedContexts

Uma estrutura MBN_CONTEXT que especifica o contexto provisionado a ser armazenado no dispositivo ou sim.

[in] providerID

Uma cadeia de caracteres que representa a ID do provedor de rede para a qual o contexto provisionado deve ser armazenado. O dispositivo deve retornar o contexto provisionado adicionado em resposta a qualquer consulta subsequente quando um SIM com essa ID do provedor inicial estiver no dispositivo.

[out] requestID

Uma ID de solicitação definida pelo serviço de Banda Larga Móvel para identificar essa solicitação assíncrona.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 O método foi concluído com sucesso.
E_HANDLE
 Interface inválida. Provavelmente, o dispositivo de Banda Larga Móvel foi removido do sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 Interface inválida. Provavelmente, o dispositivo de Banda Larga Móvel foi removido do sistema.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 O serviço de Banda Larga Móvel não está em execução neste sistema.
E_INVALID_ARG
 providerID não é válido.

Comentários

A contextID de provisionedContexts especifica o índice na memória do dispositivo ou sim em que o contexto deve ser armazenado. Se estiver definido como MBN_CONTEXT_ID_APPEND, o dispositivo encontrará o índice apropriado para armazenar o contexto.

Essa é uma operação assíncrona e SetProvisionedContext retornará imediatamente. Quando a operação for concluída, o serviço de Banda Larga Móvel notificará o aplicativo chamando o método OnSetProvisionedContextComplete de IMbnConnectionContextEvents.

As adições à lista de contexto provisionada para a ID do provedor inicial atual não estarão disponíveis para consulta até que o método OnProvisionedContextListChange de IMbnConnectionContextEvents tenha sido chamado.

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

IMbnConnectionContext