Método IMbnServiceActivationEvents::OnActivationComplete (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.

Método de notificação chamado pelo serviço de Banda Larga Móvel para indicar que uma solicitação de ativação de serviço foi concluída.

Sintaxe

HRESULT OnActivationComplete(
  [in] IMbnServiceActivation *serviceActivation,
  [in] SAFEARRAY             *vendorSpecificData,
  [in] ULONG                 requestID,
  [in] HRESULT               status,
  [in] ULONG                 networkError
);

Parâmetros

[in] serviceActivation

Ponteiro para uma interface IMbnServiceActivation que representa o dispositivo no qual a solicitação foi executada.

[in] vendorSpecificData

Uma matriz de bytes que contém os dados retornados pelo miniportor de Banda Larga Móvel subjacente em NDIS_STATUS_WWAN_SERVICE_ACTIVATION.

[in] requestID

A ID da solicitação atribuída pelo serviço de Banda Larga Móvel quando a solicitação foi inicializada.

[in] status

A conclusão status.

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

Valor	Significado
S_OK	A operação foi bem-sucedida.
E_INVALIDARG	O driver de miniporto detectou dados de entrada incorretos na solicitação.
E_MBN_PIN_REQUIRED	Um PIN é necessário para que a operação seja concluída.
E_MBN_RADIO_POWER_OFF	O dispositivo de banda larga móvel não está ligado.
E_MBN_PROVIDER_NOT_VISIBLE	O provedor de serviços não está visível.
E_MBN_SIM_NOT_INSERTED	Não há nenhum SIM no dispositivo.
E_MBN_BAD_SIM	Há um SIM inválido no dispositivo.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	O dispositivo não dá suporte a essa operação.

[in] networkError

O código de erro retornado pela rede durante a operação de ativação. Esse valor só é significativo quando status não é S_OK.

O valor exato de networkError é dependente de driver/rede.

Retornar valor

Esse método deve retornar S_OK.

Comentários

A ativação bem-sucedida do serviço também resultará em uma alteração no estado pronto do dispositivo. o serviço de Banda Larga Móvel chamará o método OnReadyStateChange de IMbnInterfaceEvents como notificaçã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

IMbnServiceActivationEvents