structure WWAN_SET_CONTEXT (wwan.h)

La structure WWAN_SET_CONTEXT représente un contexte provisionné avec une identification de fournisseur réseau prise en charge par l’appareil Mo.

Syntaxe

typedef struct _WWAN_SET_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;
  WCHAR              ProviderId[WWAN_PROVIDERID_LEN];
} WWAN_SET_CONTEXT, *PWWAN_SET_CONTEXT;

Membres

ContextId

ID unique pour ce contexte.

Pour définir OID_WWAN_PROVISIONED_CONTEXT demandes, 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 aux 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 APN (Access Point Name) 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 avoir la valeur 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 avoir la valeur NULL.

Password[WWAN_PASSWORD_LEN]

Mot de passe à utiliser pour l’authentification. Ce membre peut avoir la valeur 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 MB définit ce membre sur WwanCompressionNone pour les appareils CDMA.

AuthType

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

ProviderId[WWAN_PROVIDERID_LEN]

Chaîne terminée par null qui représente l’identification du fournisseur de réseau pour laquelle le contexte provisionné doit être stocké dans set OID_WWAN_PROVISIONED_CONTEXT requêtes. Les pilotes miniport doivent retourner le contexte provisionné ajouté en réponse aux opérations de requête suivantes lorsqu’un module d’identité d’abonné (carte SIM) avec cet ID de fournisseur de base se trouve dans l’appareil.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 7 et versions ultérieures de Windows.
En-tête	wwan.h (inclure Wwan.h)