IMbnSms::SmsRead 메서드(mbnapi.h)

중요

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

디바이스에서 SMS 메시지 집합을 읽습니다.

구문

HRESULT SmsRead(
  [in]  MBN_SMS_FILTER *smsFilter,
  [in]  MBN_SMS_FORMAT smsFormat,
  [out] ULONG          *requestID
);

매개 변수

[in] smsFilter

읽을 메시지 집합을 정의하는 MBN_SMS_FILTER 구조체에 대한 포인터입니다.

[in] smsFormat

SMS 메시지를 읽어야 하는 형식을 지정하는 MBN_SMS_FORMAT 값입니다.

GSM 디바이스의 경우 항상 MBN_SMS_FORMAT_PDU 합니다.

CDMA 디바이스의 경우 MBN_SMS_FORMAT_PDU 지정된 경우 디바이스는 이진 모드 CDMA 메시지를 읽습니다. MBN_SMS_FORMAT_TEXT 지정된 경우 디바이스는 텍스트 모드 CDMA 메시지를 읽습니다. 디바이스가 지정된 형식을 지원하지 않는 경우 오류 코드를 반환할 수 있습니다.

[out] requestID

이 요청을 식별하기 위해 모바일 광대역 서비스에서 발급한 요청 ID에 대한 포인터입니다.

반환 값

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

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

설명

애플리케이션은 smsFilter를 사용하여 인덱스를 사용하여 새 메시지, 초안 메시지 또는 특정 메시지와 같은 기본 필터를 지정할 수 있습니다. 복잡한 필터는 기본 필터의 조합을 통합하여 사용할 수 있습니다. 모든 인터페이스는 인덱스 기반 필터 및 새 메시지 유형 필터를 지원합니다. 다른 필터에 대한 지원은 일부 인터페이스에 대해 선택 사항입니다. 지정된 필터가 지원되지 않으면 작업 완료 콜백 함수는 E_MBN_STATUS_FILTER_NOT_SUPPORTED 상태 반환합니다.

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

요구 사항

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

참고 항목

IMbnSms