Método IMbnConnectionContext::SetProvisionedContext (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.

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