Partager via


structure WWAN_SET_CONTEXT (wwan.h)

La structure WWAN_SET_CONTEXT représente un contexte provisionné avec une identification de fournisseur de 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 des requêtes 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 à requête OID_WWAN_PROVISIONED_CONTEXT demandes.

ContextType

Spécifie le type de contexte représenté, par exemple, connectivité Internet, VPN (connexion à un réseau d’entreprise) ou VoIP (Voice-over-IP). 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’agirait d’une chaîne APN (Access Point Name) telle que « data.thephone-company.com ». Pour les réseaux CDMA, il peut s’agir d’un code de numérotation spécial tel que « #777 » ou 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.

ProviderId[WWAN_PROVIDERID_LEN]

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

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Windows 7 et versions ultérieures de Windows.
d’en-tête wwan.h (include Wwan.h)