IMbnConnectionContext::GetProvisionedContexts 메서드(mbnapi.h)
중요
Windows 10 버전 1803부터 이 섹션에 설명된 Win32 API는 Windows.Networking.Connectivity 네임스페이스의 Windows 런타임 API로 대체됩니다.
연결 컨텍스트 목록을 가져옵니다.
구문
HRESULT GetProvisionedContexts(
[out, retval] SAFEARRAY **provisionedContexts
);
매개 변수
[out, retval] provisionedContexts
디바이스에 저장된 연결 컨텍스트를 나타내는 MBN_CONTEXT 값 목록입니다. 오류 발생시 이 배열은 NULL입니다. 성공하면 호출 애플리케이션은 SafeArrayDestroy를 호출하여 할당된 메모리를 해제해야 합니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | Description |
|---|---|
|
메서드가 완료되었습니다. |
|
연결 컨텍스트를 사용할 수 없습니다. 모바일 광대역 서비스는 디바이스에서 정보를 검색하고 있습니다. IMbnConnectionContextEvents의 OnProvisionedContextListChange 메서드에 등록하여 연결 컨텍스트를 사용할 수 있는 경우 호출 애플리케이션에 알림을 받을 수 있습니다. |
|
연결 컨텍스트를 얻으려면 PIN이 필요합니다. |
|
SIM이 디바이스에 삽입되지 않습니다. |
|
잘못된 SIM이 디바이스에 삽입됩니다. |
|
디바이스는 프로비전된 컨텍스트의 검색을 지원하지 않습니다. |
설명
연결 컨텍스트는 계층 2에서 물리적 모바일 광대역 연결 위에 가상 회로 또는 흐름을 설정하기 위한 특정 네트워크 구성 매개 변수 집합의 추상화입니다. GSM에서는 PDP 컨텍스트의 개념에 해당합니다. CDMA에서 네트워크 프로필에 해당합니다.
경우에 따라 디바이스/SIM 메모리에서 연결 매개 변수를 이미 사용할 수 있습니다. 이 메서드를 사용하여 현재 홈 공급자 네트워크의 디바이스에 저장된 저장된 연결 컨텍스트 목록을 가져올 수 있습니다.
MBN_CONTEXT_TYPE_INTERNET 형식의 컨텍스트만 데이터 연결을 만드는 데 사용해야 합니다.
디바이스는 현재 홈 공급자에 대해 저장된 모든 컨텍스트를 반환합니다. 일부 컨텍스트는 비어 있을 수 있으며 MBN_CONTEXT_TYPE_NONE 보고됩니다.
경우에 따라 SMS 또는 OTA를 통해 네트워크에서 저장된 프로비전된 컨텍스트를 업데이트할 수 있습니다. 디바이스 프로비전 컨텍스트가 변경될 때마다 모바일 광대역 서비스는 IMbnConnectionContextEvents의 OnProvisionedContextListChange 메서드를 호출합니다. 그런 다음 애플리케이션은 이 메서드를 사용하여 프로비전된 컨텍스트의 업데이트된 목록을 가져올 수 있습니다.
복구 가능한 오류 E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED 및 E_MBN_BAD_SIM 경우 모바일 광대역 서비스는 오류 조건이 끝나면 디바이스에서 이 정보를 다시 쿼리합니다. 예를 들어 디바이스에서 연결 컨텍스트를 검색하기 위해 PIN을 입력해야 하는 경우 E_MBN_PIN_REQUIRED 반환합니다. 애플리케이션이 PIN을 입력하여 디바이스의 잠금을 해제하면 서비스에서 디바이스에서 이 정보를 다시 가져옵니다. 서비스는 IMbnConnectionContextEvents의 OnProvisionedContextListChange 메서드를 호출하여 새 쿼리의 상태 대한 애플리케이션을 업데이트합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 대상 플랫폼 | Windows |
| 헤더 | mbnapi.h |