Compartir a través de

estructura MBN_CONTEXT (mbnapi.h)

  • Artículo

Importante

A partir de Windows 10, versión 1803, las API de Win32 descritas en esta sección se reemplazan por las API de Windows Runtime en el espacio de nombres Windows.Networking.Connectivity.

La estructura MBN_CONTEXT almacena información sobre el contexto de conexión.

Sintaxis

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;

Miembros

contextID

Contiene el identificador único de este contexto. Representa el índice de contexto en el dispositivo o la memoria SIM. Si se establece en MBN_CONTEXT_ID_APPEND, el dispositivo encontrará el índice adecuado para almacenar el contexto.

contextType

Valor MBN_CONTEXT_TYPE que especifica el tipo de contexto. Una aplicación puede usar este miembro para modificar el contexto almacenado en un índice determinado mediante el método SetProvisionedContext de IMbnConnectionContext.

accessString

Contiene información de acceso específica de la conexión. En las redes GSM, sería un nombre de punto de acceso (APN), como "data.thephone-company.com". En las redes SERVICE, esto podría ser un código de marcado especial, como "#777" o un NAI (identificador de acceso de red) como "somebody@thephone-company.com".

Esta cadena no debe superar MBN_ACCESSSTRING_LEN caracteres. Para obtener la definición de MBN_ACCESSTRING_LEN, consulte MBN_CONTEXT_CONSTANTS. Esta cadena puede estar vacía. La aplicación que realiza la llamada debe liberar esta cadena llamando a SysFreeString.

userName

Contiene el nombre de usuario que se usa para la autenticación.

La cadena no debe superar MBN_USERNAME_LEN caracteres. La aplicación que realiza la llamada debe liberar esta cadena llamando a SysFreeString. Para obtener la definición de MBN_USERNAME_LEN, consulte MBN_CONTEXT_CONSTANTS. La aplicación que realiza la llamada debe liberar esta cadena llamando a SysFreeString.

password

Contiene la contraseña que se usa para la autenticación.

La cadena no debe superar MBN_PASSWORD_LEN caracteres. Esta cadena puede estar vacía. Para obtener la definición de MBN_PASSWORD_LEN, consulte MBN_CONTEXT_CONSTANTS. La aplicación que realiza la llamada debe liberar esta cadena llamando a SysFreeString.

compression

Valor de MBN_COMPRESSION que especifica si la compresión se usa en el vínculo de datos para el encabezado y los datos.

Este miembro solo es aplicable para dispositivos GSM.

authType

Valor MBN_AUTH_PROTOCOL que indica el tipo de compresión que se usa para la activación de PDP (Protocolo de datos de paquetes).

Este miembro solo es aplicable para dispositivos GSM. En el caso de los dispositivos FRAMEWORK, se establece en MBN_AUTH_PROTOCOL_NONE.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Encabezado mbnapi.h