structure MBN_CONTEXT (mbnapi.h)

La structure MBN_CONTEXT stocke des informations sur le contexte de connexion.

Syntaxe

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;

Membres

contextID

Contient l’identificateur unique pour ce contexte. Cela représente l’index de contexte dans la mémoire de l’appareil ou de la carte SIM. S’il est défini sur MBN_CONTEXT_ID_APPEND, l’appareil trouvera l’index approprié pour stocker le contexte.

contextType

Valeur MBN_CONTEXT_TYPE qui spécifie le type de contexte. Une application peut utiliser ce membre pour modifier le contexte stocké à un index particulier à l’aide de la méthode SetProvisionedContext de IMbnConnectionContext.

accessString

Contient des informations d’accès spécifiques à la connexion. Dans les réseaux GSM, il s’agit d’un nom de point d’accès (APN) tel que « data.thephone-company.com ». Dans les réseaux 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 «somebody@thephone-company.com ».

Cette chaîne ne doit pas dépasser MBN_ACCESSSTRING_LEN caractères. Pour la définition de MBN_ACCESSTRING_LEN, consultez MBN_CONTEXT_CONSTANTS. Cette chaîne peut être vide. L’application appelante doit libérer cette chaîne en appelant SysFreeString.

userName

Contient le nom d’utilisateur utilisé pour l’authentification.

La chaîne ne doit pas dépasser MBN_USERNAME_LEN caractères. L’application appelante doit libérer cette chaîne en appelant SysFreeString. Pour la définition de MBN_USERNAME_LEN, consultez MBN_CONTEXT_CONSTANTS. L’application appelante doit libérer cette chaîne en appelant SysFreeString.

password

Contient le mot de passe utilisé pour l’authentification.

La chaîne ne doit pas dépasser MBN_PASSWORD_LEN caractères. Cette chaîne peut être vide. Pour obtenir la définition de MBN_PASSWORD_LEN, consultez MBN_CONTEXT_CONSTANTS. L’application appelante doit libérer cette chaîne en appelant SysFreeString.

compression

Valeur MBN_COMPRESSION qui spécifie si la compression est utilisée dans la liaison de données pour l’en-tête et les données.

Ce membre s’applique uniquement aux appareils GSM.

authType

Valeur MBN_AUTH_PROTOCOL qui indique le type de compression utilisé pour l’activation du protocole PDP (Packet Data Protocol).

Ce membre s’applique uniquement aux appareils GSM. Pour les appareils CDMA, il est défini sur MBN_AUTH_PROTOCOL_NONE.

Configuration requise