MBN_CONTEXT 構造体 (mbnapi.h)

重要

バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows ランタイム API に置き換えられます。

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 値。 アプリケーションでは、このメンバーを使用して、IMbnConnectionContext の SetProvisionedContext メソッドを使用して、特定のインデックスに格納されているコンテキストを変更できます。

accessString

接続固有のアクセス情報が含まれます。 GSM ネットワークでは、これは "data.thephone-company.com" などのアクセス ポイント名 (APN) になります。 CDMA ネットワークでは、"#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

PDP (パケット データ プロトコル) のアクティブ化に使用される圧縮の種類を示す MBN_AUTH_PROTOCOL 値。

このメンバーは、GSM デバイスにのみ適用されます。 CDMA デバイスの場合は、 MBN_AUTH_PROTOCOL_NONEに設定されます。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
Header	mbnapi.h