Condividi tramite

struttura MBN_CONTEXT (mbnapi.h)

  • Articolo

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.

La struttura MBN_CONTEXT archivia le informazioni sul contesto di connessione.

Sintassi

typedef struct MBN_CONTEXT {
  ULONG             contextID;
  MBN_CONTEXT_TYPE  contextType;
  BSTR              accessString;
  BSTR              userName;
  BSTR              password;
  MBN_COMPRESSION   compression;
  MBN_AUTH_PROTOCOL authType;
} MBN_CONTEXT;

Members

contextID

Contiene l'identificatore univoco per questo contesto. Rappresenta l'indice di contesto nel dispositivo o nella memoria SIM. Se è impostato su MBN_CONTEXT_ID_APPEND, il dispositivo troverà l'indice appropriato per archiviare il contesto.

contextType

Valore MBN_CONTEXT_TYPE che specifica il tipo di contesto. Un'applicazione può usare questo membro per modificare il contesto archiviato in un determinato indice usando il metodo SetProvisionedContext di IMbnConnectionContext.

accessString

Contiene informazioni di accesso specifiche della connessione. Nelle reti GSM, si tratta di un nome del punto di accesso (APN), ad esempio "data.thephone-company.com". Nelle reti CDMA, potrebbe trattarsi di un codice di composizione speciale, ad esempio "#777" o un NAI (Network Access Identifier), ad esempio "somebody@thephone-company.com".

Questa stringa non deve superare MBN_ACCESSSTRING_LEN caratteri. Per la definizione di MBN_ACCESSTRING_LEN, vedere MBN_CONTEXT_CONSTANTS. Questa stringa può essere vuota. L'applicazione chiamante deve liberare questa stringa chiamando SysFreeString.

userName

Contiene il nome utente utilizzato per l'autenticazione.

La stringa non deve superare MBN_USERNAME_LEN caratteri. L'applicazione chiamante deve liberare questa stringa chiamando SysFreeString. Per la definizione di MBN_USERNAME_LEN, vedere MBN_CONTEXT_CONSTANTS. L'applicazione chiamante deve liberare questa stringa chiamando SysFreeString.

password

Contiene la password utilizzata per l'autenticazione.

La stringa non deve superare MBN_PASSWORD_LEN caratteri. Questa stringa può essere vuota. Per la definizione di MBN_PASSWORD_LEN, vedere MBN_CONTEXT_CONSTANTS. L'applicazione chiamante deve liberare questa stringa chiamando SysFreeString.

compression

Valore MBN_COMPRESSION che specifica se la compressione viene utilizzata nel collegamento dati per l'intestazione e i dati.

Questo membro è applicabile solo per i dispositivi GSM.

authType

Valore MBN_AUTH_PROTOCOL che indica il tipo di compressione utilizzata per l'attivazione PDP (Packet Data Protocol).

Questo membro è applicabile solo per i dispositivi GSM. Per i dispositivi CDMA, è impostato su MBN_AUTH_PROTOCOL_NONE.

Requisiti

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