IMbnServiceActivationEvents::OnActivationComplete 메서드(mbnapi.h)

중요

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

서비스 활성화 요청이 완료되었음을 나타내기 위해 모바일 광대역 서비스에서 호출한 알림 메서드입니다.

구문

HRESULT OnActivationComplete(
  [in] IMbnServiceActivation *serviceActivation,
  [in] SAFEARRAY             *vendorSpecificData,
  [in] ULONG                 requestID,
  [in] HRESULT               status,
  [in] ULONG                 networkError
);

매개 변수

[in] serviceActivation

요청이 수행된 디바이스를 나타내는 IMbnServiceActivation 인터페이스에 대한 포인터입니다.

[in] vendorSpecificData

NDIS_STATUS_WWAN_SERVICE_ACTIVATION 기본 모바일 광대역 미니포트 드라이버가 반환한 데이터를 포함하는 바이트 배열입니다.

[in] requestID

요청이 초기화될 때 모바일 광대역 서비스에서 할당한 요청 ID입니다.

[in] status

완료 상태.

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

값	의미
S_OK	작업이 완료되었습니다.
E_INVALIDARG	미니포트 드라이버가 요청에서 잘못된 입력 데이터를 검색했습니다.
E_MBN_PIN_REQUIRED	작업을 완료하려면 PIN이 필요합니다.
E_MBN_RADIO_POWER_OFF	모바일 광대역 디바이스가 전원이 켜지지 않습니다.
E_MBN_PROVIDER_NOT_VISIBLE	서비스 공급자가 표시되지 않습니다.
E_MBN_SIM_NOT_INSERTED	디바이스에 SIM이 없습니다.
E_MBN_BAD_SIM	디바이스에 잘못된 SIM이 있습니다.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	디바이스는 이 작업을 지원하지 않습니다.

[in] networkError

활성화 작업 중에 네트워크에서 반환된 오류 코드입니다. 이 값은 상태 S_OK 않은 경우에만 의미가 있습니다.

networkError의 정확한 값은 드라이버/네트워크에 따라 다릅니다.

반환 값

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

설명

서비스 활성화가 성공하면 디바이스의 준비 상태도 변경됩니다. 모바일 광대역 서비스는 IMbnInterfaceEvents의 OnReadyStateChange 메서드를 알림으로 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	mbnapi.h

추가 정보

IMbnServiceActivationEvents