IMbnConnectionEvents::OnConnectComplete 메서드(mbnapi.h)

중요

Windows 10 버전 1803부터 이 섹션에 설명된 Win32 API는 Windows.Networking.Connectivity 네임스페이스의 Windows 런타임 API로 대체됩니다.

연결 작업의 완료를 알리는 알림 메서드입니다.

구문

HRESULT OnConnectComplete(
  [in] IMbnConnection *newConnection,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

[in] newConnection

연결 작업이 완료된 디바이스를 나타내는 IMbnConnection 인터페이스입니다.

[in] requestID

연결 작업을 식별하기 위해 모바일 광대역 서비스에서 할당한 요청 ID입니다.

[in] status

완료 상태.

호출 애플리케이션은 다음 값 중 하나를 예상할 수 있습니다.

값	의미
S_OK	작업이 완료되었습니다.
E_MBN_SIM_NOT_INSERTED	디바이스에 SIM이 없습니다.
E_MBN_PIN_REQUIRED	작업을 완료하려면 PIN이 필요합니다.
E_MBN_SERVICE_NOT_ACTIVATED	네트워크 서비스 구독이 만료되었습니다.
E_MBN_PROVIDER_NOT_VISIBLE	공급자가 표시되지 않습니다. 수동 등록 모드에만 적용됩니다.
E_MBN_INVALID_ACCESS_STRING	연결 액세스 문자열이 올바르지 않습니다.
HRESULT_FROM_WIN32(ERROR_INVALID_PASSWORD)	연결 프로필에서 를 사용하는 이름 또는 암호가 올바르지 않습니다.
E_MBN_VOICE_CALL_IN_PROGRESS	활성 음성 통화가 진행 중입니다.
E_MBN_MAX_ACTIVATED_CONTEXTS	모바일 광대역 컨텍스트가 이미 활성화되어 있습니다. 모바일 광대역 서비스는 현재 여러 활성 컨텍스트를 지원하지 않습니다.
E_MBN_RADIO_POWER_OFF	디바이스 라디오가 꺼져 있습니다.
E_MBN_PACKET_SVC_DETACHED	활성 연결된 패킷 서비스를 사용할 수 없습니다.
E_MBN_ACTIVE_CONNECTION	디바이스가 이미 네트워크에 연결되어 있습니다.

이 메서드는 S_OK 반환해야 합니다.

활성화 컨텍스트가 설정되면 애플리케이션에서 IMbnConnection 을 사용하여 현재 연결 상태를 가져올 수 있습니다.

연결 작업으로 인해 오류가 발생하면 애플리케이션에서 IMbnConnection 인터페이스의 GetActivationNetworkError 메서드를 호출하여 네트워크 오류 정보를 가져올 수 있습니다.