структура MBN_CONTEXT (mbnapi.h)

Важно!

Начиная с Windows 10 версии 1803, API Win32, описанные в этом разделе, заменяются среда выполнения Windows API в пространстве имен Windows.Networking.Connectivity.

В структуре MBN_CONTEXT хранятся сведения о контексте подключения.

Синтаксис

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;

Члены

contextID

Содержит уникальный идентификатор для этого контекста. Представляет индекс контекста в памяти устройства или SIM-карты. Если задано значение MBN_CONTEXT_ID_APPEND, устройство найдет соответствующий индекс для хранения контекста.

contextType

Значение MBN_CONTEXT_TYPE , указывающее тип контекста. Приложение может использовать этот элемент для изменения контекста, хранящегося в определенном индексе, с помощью метода SetProvisionedContextобъекта IMbnConnectionContext.

accessString

Содержит сведения о доступе для конкретного подключения. В сетях GSM это имя точки доступа (APN), например "data.thephone-company.com". В сетях CDMA это может быть специальный код набора, например "No 777", или NAI (идентификатор доступа к сети), например "somebody@thephone-company.com".

Длина этой строки не должна превышать MBN_ACCESSSTRING_LEN символов. Определение MBN_ACCESSTRING_LEN см. в разделе MBN_CONTEXT_CONSTANTS. Эта строка может быть пустой. Вызывающее приложение должно освободить эту строку, вызвав SysFreeString.

userName

Содержит имя пользователя, используемое для проверки подлинности.

Длина строки не должна превышать MBN_USERNAME_LEN символов. Вызывающее приложение должно освободить эту строку, вызвав SysFreeString. Определение MBN_USERNAME_LEN см. в разделе MBN_CONTEXT_CONSTANTS. Вызывающее приложение должно освободить эту строку, вызвав SysFreeString.

password

Содержит пароль, используемый для проверки подлинности.

Длина строки не должна превышать MBN_PASSWORD_LEN символов. Эта строка может быть пустой. Определение MBN_PASSWORD_LEN см. в разделе MBN_CONTEXT_CONSTANTS. Вызывающее приложение должно освободить эту строку, вызвав SysFreeString.

compression

Значение MBN_COMPRESSION , указывающее, используется ли сжатие в канале данных для заголовка и данных.

Этот член применим только для устройств GSM.

authType

Значение MBN_AUTH_PROTOCOL , указывающее тип сжатия, используемого для активации PDP (по протоколу пакетных данных).

Этот член применим только для устройств GSM. Для устройств CDMA задано значение MBN_AUTH_PROTOCOL_NONE.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Верхняя часть	mbnapi.h