Metodo IMbnConnectionContext::SetProvisionedContext (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.

Aggiunge o aggiorna un contesto di cui è stato effettuato il provisioning.

Sintassi

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

Parametri

[in] provisionedContexts

Struttura MBN_CONTEXT che specifica il contesto di cui è stato effettuato il provisioning da archiviare nel dispositivo o nella SIM.

[in] providerID

Stringa che rappresenta l'ID del provider di rete per il quale deve essere archiviato il contesto di cui è stato effettuato il provisioning. Il dispositivo deve restituire il contesto di provisioning aggiunto in risposta a qualsiasi query successiva quando una SIM con questo ID provider home si trova nel dispositivo.

[out] requestID

ID richiesta impostato dal servizio Mobile Broadband per identificare questa richiesta asincrona.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
E_HANDLE	Interfaccia non valida. Molto probabilmente il dispositivo Mobile Broadband è stato rimosso dal sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Interfaccia non valida. Molto probabilmente il dispositivo Mobile Broadband è stato rimosso dal sistema.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Il servizio Mobile Broadband non è in esecuzione in questo sistema.
E_INVALID_ARG	providerID non valido.

Commenti

Il contextID di provisionedContexts specifica l'indice nel dispositivo o nella memoria SIM in cui deve essere archiviato il contesto. Se è impostato su MBN_CONTEXT_ID_APPEND, il dispositivo troverà l'indice appropriato per archiviare il contesto.

Si tratta di un'operazione asincrona e SetProvisionedContext restituirà immediatamente. Al termine dell'operazione, il servizio Mobile Broadband invia una notifica all'applicazione chiamando il metodo OnSetProvisionedContextComplete di IMbnConnectionContextEvents.

Le aggiunte all'elenco di contesto di cui è stato effettuato il provisioning per l'ID del provider home corrente non saranno disponibili per l'esecuzione di query finché non viene chiamato il metodo OnProvisionedContextListChange di IMbnConnectionContextEvents .

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

IMbnConnectionContext

Condividi tramite