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 ha completato un'operazione di registrazione impostata.
Sintassi
HRESULT OnSetRegisterModeComplete(
[in] IMbnRegistration *newInterface,
[in] ULONG requestID,
[in] HRESULT status
);
Parametri
[in] newInterface
Puntatore a un'interfaccia IMbnRegistration che rappresenta il dispositivo applicabile. L'applicazione di gestione può usare questa interfaccia per ottenere lo stato di registrazione corrente del dispositivo.
[in] requestID
ID richiesta assegnato dal servizio Mobile Broadband per tenere traccia dell'operazione di registrazione del set.
[in] status
Codice di stato che indica il risultato dell'operazione.
Un'applicazione chiamante può prevedere uno dei valori possibili.
| Valore |
Significato |
-
S_OK
|
L'operazione è stata completata.
|
-
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
|
Esiste già una connessione di rete attiva. La modalità di registrazione non può essere modificata quando è presente una connessione dati già stabilita. L'applicazione deve prima disconnettere la connessione e quindi provare a modificare la modalità di registrazione. Se il dispositivo è già in modalità richiesta e connesso al provider richiesto, il codice restituito verrà S_OK.
|
-
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
|
L'operazione non è supportata dal dispositivo. Questa operazione può essere restituita dai dispositivi che non supportano la modalità di registrazione richiesta. Ad esempio, un dispositivo CDMA restituirà questo errore quando viene richiesto di passare alla modalità di registrazione manuale.
|
-
E_FAIL
|
Impossibile completare l'operazione. Altre informazioni sono disponibili nel codice di errore di rete.
|
-
E_INVALIDARG
|
L'input in modalità di registrazione non valido o l'ID provider fornito come input è superiore alla lunghezza massima di 7 caratteri o classe di dati specificata non è valido. Il servizio Mobile Broadband non invierà la richiesta al dispositivo quando nell'input vengono forniti argomenti non validi.
In modalità di registrazione manuale, questo indica che il provider richiesto non è consentito.
|
-
E_MBN_PIN_REQUIRED
|
Per completare l'operazione è necessario un PIN.
|
-
E_MBN_SERVICE_NOT_ACTIVATED
|
La sottoscrizione del servizio di rete è scaduta.
|
-
E_MBN_PROVIDER_NOT_VISIBLE
|
Ciò si verifica solo quando si passa alla modalità di registrazione manuale. L'opzione ha esito positivo, ma il provider richiesto non è visibile. Il dispositivo verrà registrato nel provider richiesto quando è visibile.
|
Valore restituito
Questo metodo deve restituire S_OK.
Requisiti
| |
|
|
Client minimo supportato |
Windows 7 [app desktop | App UWP] |
|
Server minimo supportato |
Nessuno supportato |
|
Piattaforma di destinazione |
Windows |
|
Intestazione |
mbnapi.h |
Vedi anche
IMbnRegistrationEvents