MBN_CONTEXT 구조체(mbnapi.h)

중요

Windows 10 버전 1803부터 이 섹션에 설명된 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"과 같은 특수 다이얼 코드 또는 ""와 같은somebody@thephone-company.com NAI(네트워크 액세스 식별자)일 수 있습니다.

이 문자열은 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 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
머리글	mbnapi.h