Metodo IMbnServiceActivationEvents::OnActivationComplete (mbnapi.h)

Articolo
03/05/2024

Importante

A partire da Windows 10 versione 1803, le API Win32 descritte in questa sezione vengono sostituite dalle API Windows Runtime nello spazio dei nomi Windows.Networking.Connectivity.

Metodo di notifica chiamato dal servizio Mobile Broadband per indicare che una richiesta di attivazione del servizio è stata completata.

Sintassi

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

Parametri

[in] serviceActivation

Puntatore a un'interfaccia IMbnServiceActivation che rappresenta il dispositivo in cui è stata eseguita la richiesta.

[in] vendorSpecificData

Matrice di byte contenente i dati restituiti dal driver miniport Mobile Broadband sottostante in NDIS_STATUS_WWAN_SERVICE_ACTIVATION.

[in] requestID

ID richiesta assegnato dal servizio Mobile Broadband quando la richiesta è stata inizializzata.

[in] status

Stato di completamento.

Un'applicazione chiamante può prevedere uno dei valori seguenti.

Valore	Significato
S_OK	L'operazione è stata completata.
E_INVALIDARG	Il driver miniport ha rilevato dati di input non corretti nella richiesta.
E_MBN_PIN_REQUIRED	Per completare l'operazione è necessario un PIN.
E_MBN_RADIO_POWER_OFF	Il dispositivo Mobile Broadband non è alimentato.
E_MBN_PROVIDER_NOT_VISIBLE	Il provider di servizi non è visibile.
E_MBN_SIM_NOT_INSERTED	Non è presente alcuna SIM nel dispositivo.
E_MBN_BAD_SIM	Nel dispositivo è presente una sim non valida.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Il dispositivo non supporta questa operazione.

[in] networkError

Codice di errore restituito dalla rete durante l'operazione di attivazione. Questo valore è significativo solo quando lo stato non è S_OK.

Il valore esatto di networkError è dipendente dal driver/dalla rete.

Valore restituito

Questo metodo deve restituire S_OK.

Commenti

L'attivazione del servizio con esito positivo comporta anche una modifica allo stato pronto del dispositivo. il servizio Mobile Broadband chiamerà il metodo OnReadyStateChange di IMbnInterfaceEvents come notifica.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	mbnapi.h

Vedi anche

IMbnServiceActivationEvents

Condividi tramite