Método IMbnSms::SmsRead (mbnapi.h)
Importante
A partir do Windows 10, versão 1803, as APIs do Win32 descritas nesta seção são substituídas pelas APIs Windows Runtime no namespace Windows.Networking.Connectivity.
Lê um conjunto de mensagens SMS de um dispositivo.
Sintaxe
HRESULT SmsRead(
[in] MBN_SMS_FILTER *smsFilter,
[in] MBN_SMS_FORMAT smsFormat,
[out] ULONG *requestID
);
Parâmetros
[in] smsFilter
Um ponteiro para uma estrutura MBN_SMS_FILTER que define o conjunto de mensagens a serem lidas.
[in] smsFormat
Um valor MBN_SMS_FORMAT que especifica o formato no qual uma mensagem SMS deve ser lida.
Para dispositivos GSM, ele sempre deve ser MBN_SMS_FORMAT_PDU.
Para dispositivos CDMA, se isso for especificado como MBN_SMS_FORMAT_PDU, o dispositivo lerá uma mensagem CDMA no modo binário. Se for especificado como MBN_SMS_FORMAT_TEXT, o dispositivo lerá uma mensagem CDMA no modo de texto. Se o dispositivo não der suporte ao formato especificado, ele poderá retornar um código de erro.
[out] requestID
Um ponteiro para uma ID de solicitação emitida pelo serviço de Banda Larga Móvel para identificar essa solicitação.
Valor retornado
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
O método foi concluído com sucesso. |
|
O serviço de Banda Larga Móvel não está em execução neste sistema. |
|
A interface é inválida, provavelmente porque o dispositivo foi removido do sistema. |
|
A interface é inválida. Provavelmente, o dispositivo de Banda Larga Móvel foi removido do sistema. |
|
smsFormat ou smsFilter é inválido. |
Comentários
Usando smsFilter, um aplicativo pode especificar filtros básicos, como novas mensagens, mensagens de rascunho ou uma mensagem específica usando um índice. Um filtro complexo pode ser usado integrando uma combinação de filtros básicos. Todas as interfaces dão suporte aos filtros baseados em índice e aos novos filtros de tipo de mensagem. O suporte para outros filtros é opcional para algumas interfaces. Se não houver suporte para o filtro especificado, a função de retorno de chamada de conclusão da operação retornará um status de E_MBN_STATUS_FILTER_NOT_SUPPORTED.
Essa é uma operação assíncrona que retornará imediatamente. Se o método retornar sem erro, o serviço de Banda Larga Móvel chamará o método OnSmsReadComplete da interface IMbnSmsEvents .
Requisitos
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | mbnapi.h |