structure WWAN_CONTEXT (wwan.h)

Article
03/05/2024

La structure WWAN_CONTEXT représente un contexte provisionné pris en charge par l’appareil Mo.

Syntaxe

typedef struct _WWAN_CONTEXT {
  ULONG              ContextId;
  WWAN_CONTEXT_TYPE  ContextType;
  WCHAR              AccessString[WWAN_ACCESSSTRING_LEN];
  WCHAR              UserName[WWAN_USERNAME_LEN];
  WCHAR              Password[WWAN_PASSWORD_LEN];
  WWAN_COMPRESSION   Compression;
  WWAN_AUTH_PROTOCOL AuthType;
} WWAN_CONTEXT, *PWWAN_CONTEXT;

Membres

ContextId

ID unique pour ce contexte.

Pour les requêtes définies OID_WWAN_PROVISIONED_CONTEXT, le service Mo peut définir la valeur sur WWAN_CONTEXT_ID_APPEND. Si cette valeur est utilisée, le pilote miniport doit décider de l’index pour stocker les informations de contexte. WWAN_CONTEXT_ID_APPEND ne doit jamais être retourné en réponse à des requêtes OID_WWAN_PROVISIONED_CONTEXT.

ContextType

Spécifie le type de contexte représenté, par exemple, connectivité Internet, VPN (connexion à un réseau d’entreprise) ou Voix sur IP (VoIP). Les pilotes miniport doivent spécifier WwanContextTypeNone pour les contextes vides ou non approvisionnés.

AccessString[WWAN_ACCESSSTRING_LEN]

Chaîne terminée par NULL pour accéder au réseau. Pour les réseaux gsm, il s’agit d’une chaîne de nom de point d’accès (APN) telle que « data.thephone-company.com ». Pour les réseaux basés sur CDMA, il peut s’agir d’un code de numérotation spécial tel que « #777 » ou d’un identificateur d’accès réseau (NAI) tel que «foo@thephone-company.com ». Ce membre peut être NULL.

La taille de la chaîne ne doit pas dépasser 100 octets.

UserName[WWAN_USERNAME_LEN]

Nom d’utilisateur à utiliser pour l’authentification. Ce membre peut être NULL.

Password[WWAN_PASSWORD_LEN]

Mot de passe à utiliser pour l’authentification. Ce membre peut être NULL.

Compression

Spécifie la compression à utiliser dans la connexion de données pour l’en-tête et les données. Ce membre s’applique uniquement aux appareils GSM. Le service Mo définit ce membre sur WwanCompressionNone pour les appareils CDMA.

AuthType

Type d’authentification à utiliser pour l’activation PDP.