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

로밍 공급자를 설명하는 로밍 텍스트를 가져옵니다.

구문

HRESULT GetRoamingText(
  [out] BSTR *roamingText
);

매개 변수

[out] roamingText

디바이스가 로밍 중인 네트워크에 대한 추가 정보가 포함된 문자열에 대한 포인터입니다. 최대 길이는 MBN_ROAMTEXT_LEN 문자입니다. 문자열은 메서드가 성공을 위해 S_OK 반환하는 경우에만 채워집니다. 성공하면 호출 애플리케이션은 SysFreeString을 호출하여 할당된 메모리를 해제해야 합니다.

반환 값

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

설명

GetRoamingText 메서드는 등록 상태가 MBN_REGISTER_STATE_PARTNER 또는MBN_REGISTER_STATE_ROAMING 때 네트워크에 대한 추가 정보가 포함된 텍스트 문자열을 가져올 수 있습니다.

이 정보는 모바일 광대역 디바이스가 한 네트워크에서 다른 네트워크로 이동할 때 변경됩니다. 여기에는 네트워크 등록 상태에서 MBN_REGISTER_STATE_HOME MBN_REGISTER_STATE_SEARCHING 변경이 있을 때마다 포함됩니다. 이는 네트워크가 등록을 한 공급자에서 다른 공급자로 이동하는 경우와 같이 등록된 네트워크에 변경이 있을 때도 발생합니다. 이러한 변경 후 모바일 광대역 서비스는 IMbnRegistrationEvents의 OnRegisterStateChange 메서드를 호출합니다.

복구 가능한 오류 E_MBN_PIN_REQUIRED 경우 모바일 광대역 서비스는 오류 조건이 끝나면(PIN을 입력할 때) 디바이스에서 이 정보를 다시 가져오려고 시도합니다. 그런 다음 IMbnRegistrationEvents의 OnRegisterStateChange 메서드를 호출합니다.

요구 사항

참고 항목

IMbnRegistration