IMbnServiceActivation::Activate 메서드(mbnapi.h)

중요

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

네트워크로 서비스 활성화 요청을 보냅니다.

구문

HRESULT Activate(
  [in]  SAFEARRAY *vendorSpecificData,
  [out] ULONG     *requestID
);

[in] vendorSpecificData

서비스 활성화 작업에서 전달된 공급업체별 바이트 배열입니다. 이 데이터는 SET OID_WWAN_SERVICE_ACTIVATION OID 요청의 모바일 광대역 서비스에서 미니포트 드라이버에 전달됩니다.

[out] requestID

이 작업에 대한 요청 ID입니다.

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	메서드가 완료되었습니다.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	모바일 광대역 서비스가 이 시스템에서 실행되고 있지 않습니다.
E_HANDLE	잘못된 인터페이스입니다. 디바이스가 시스템에서 제거되었을 가능성이 높습니다.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	인터페이스가 잘못되었습니다. 모바일 광대역 디바이스가 시스템에서 제거되었을 가능성이 높습니다. 잘못된 인터페이스입니다. 디바이스가 시스템에서 제거되었을 가능성이 높습니다.

Activate 메서드는 애플리케이션에서 셀룰러 서비스를 활성화하는 데 사용할 수 있습니다. 이 요청에 전달된 데이터 형식은 공급업체별로 다릅니다.

OID 요청의 VendorSpecificBufferSize 필드는 SAFEARRAY vendorSpecificData의 데이터 크기로 설정됩니다. vendorSpecificData의 콘텐츠는 드라이버에 대한 OID 요청에서 바이트 바이트별로 복사됩니다.

서비스 활성화 작업에 대한 자세한 내용은 모바일 광대역 드라이버 모델을 참조하세요.

즉시 반환되는 비동기 작업입니다. 메서드가 오류 없이 반환되면 모바일 광대역 서비스는 IMbnServiceActivationEvents 인터페이스의 OnActivationComplete 메서드를 호출합니다.