IMbnInterface::GetReadyState 메서드(mbnapi.h)
중요
Windows 10 버전 1803부터 이 섹션에 설명된 Win32 API는 Windows.Networking.Connectivity 네임스페이스의 Windows 런타임 API로 대체됩니다.
준비 상태를 가져옵니다.
구문
HRESULT GetReadyState(
[out, retval] MBN_READY_STATE *readyState
);
매개 변수
[out, retval] readyState
MBN_READY_STATE 구조체에 대한 포인터입니다. 이 메서드가 S_OK 이외의 값을 반환하는 경우 이 매개 변수는 NULL입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | Description |
|---|---|
|
메서드가 완료되었습니다. readyState 에는 유효한 값이 포함되어 있습니다. |
|
정보를 사용할 수 없습니다. 모바일 광대역 서비스는 현재 준비 상태를 검색하고 있습니다. IMbnInterfaceEvents의 OnReadyStateChange 메서드에 등록하여 준비 상태를 사용할 수 있는 경우 호출 애플리케이션에 알림을 받을 수 있습니다. |
설명
준비 상태는 인터페이스가 성공적으로 초기화되고 연결 작업을 수행할 준비가 되었는지 여부를 지정합니다. SIM 기반 디바이스의 경우 디바이스에서 SIM을 성공적으로 초기화하면 디바이스가 준비됩니다. 디바이스는 준비 상태가 MBN_READY_STATE_INITIALIZED 경우에만 연결에 사용할 수 있습니다. 다른 디바이스 상태에 대한 자세한 내용은 MBN_READY_STATE.
인터페이스의 준비 상태는 사용자 작업의 결과로 변경 될 수 있습니다. 예를 들어 사용자가 디바이스에 SIM을 삽입하면 준비 상태가 MBN_READY_STATE_SIM_NOT_INSERTED 다른 준비 상태로 변경됩니다. 애플리케이션에서 수행하는 다른 작업으로 인해 준비 상태가 변경될 수도 있습니다. 예를 들어 PIN을 입력하면 준비 상태가 MBN_READY_STATE_DEVICE_LOCKED 다른 준비 상태로 변경될 수 있습니다. 애플리케이션은 인터페이스의 준비 상태가 변경 될 때마다 이벤트 알림에 등록할 수 있습니다. IMbnInterfaceEvents의 OnReadyStateChange 멤버는 준비 상태의 변경 내용을 애플리케이션에 알리기 위해 호출됩니다.
MBN_READY_STATE_INITIALIZED 보고할 때 디바이스의 SMS 하위 시스템이 준비되지 않을 수 있습니다. 호출 애플리케이션은 SMS 하위 시스템이 준비되었음을 나타내는 IMbnSmsEvents의 OnSmsConfigurationChange 멤버에 대한 호출을 기다려야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 대상 플랫폼 | Windows |
| 헤더 | mbnapi.h |