IMbnRegistration::SetRegisterMode 메서드(mbnapi.h)

디바이스의 등록 모드를 설정합니다.

구문

HRESULT SetRegisterMode(
  [in]  MBN_REGISTER_MODE registerMode,
  [in]  LPCWSTR           providerID,
  [in]  ULONG             dataClass,
  [out] ULONG             *requestID
);

매개 변수

[in] registerMode

새 등록 모드를 지정하는 MBN_REGISTER_MODE 값입니다.

[in] providerID

등록할 네트워크 공급자의 공급자 ID를 지정하는 문자열입니다. registerMode가 MBN_REGISTER_MODE_AUTOMATIC 경우 NULL이어야 합니다.

[in] dataClass

연결에 대한 기본 데이터 액세스 기술을 지정하는 OR MBN_DATA_CLASS 값의 비트 조합입니다. 모바일 광대역 서비스는 이 목록에서 사용 가능한 가장 높은 데이터 클래스 기술을 등록합니다. 이 목록의 데이터 클래스를 등록할 수 없는 경우 모바일 광대역 서비스는 사용 가능한 최상의 데이터 클래스에 등록됩니다.

[out] requestID

모바일 광대역 서비스에서 이 비동기 요청을 식별하기 위해 설정한 요청 ID입니다.

반환 값

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

설명

SetRegisterMode 메서드를 사용하여 디바이스를 자동 또는 수동 네트워크 선택 모드로 설정할 수 있습니다. 수동 등록 모드의 경우 디바이스가 등록해야 하는 네트워크 ID가 providerID에 제공됩니다.

수동 등록 모드에 대한 지원은 선택 사항이며 애플리케이션은 IMbnInterface의 GetInterfaceCapability 메서드로 채워진 interfaceCaps 매개 변수에서 MBN_CTRL_CAPS_REG_MANUAL 확인하여 디바이스가 수동 등록을 지원하는지 확인해야 합니다. 애플리케이션이 수동 등록 모드를 설정하고 디바이스에서 지원하지 않는 경우 이 호출은 HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)을 반환합니다.

SetRegisterMode 는 비동기이며 즉시 반환됩니다. 오류가 없는 경우 작업이 완료되면 모바일 광대역 서비스에서 IMbnRegistrationEvents의 OnSetRegisterModeComplete 메서드를 호출합니다.

요구 사항

참고 항목

IMbnRegistration