Compartilhar via

Método IMbnSmsEvents::OnSmsReadComplete (mbnapi.h)

  • Artigo

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.

Método de notificação que indica a conclusão de uma operação de leitura de mensagem.

Sintaxe

HRESULT OnSmsReadComplete(
  [in] IMbnSms        *sms,
  [in] MBN_SMS_FORMAT smsFormat,
  [in] SAFEARRAY      *readMsgs,
  [in] VARIANT_BOOL   moreMsgs,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Parâmetros

[in] sms

Uma interface IMbnSms que representa o repositório de mensagens que concluiu a operação.

[in] smsFormat

Um valor MBN_SMS_FORMAT que define o formato da mensagem SMS.

[in] readMsgs

Uma matriz de mensagens lidas do dispositivo.

[in] moreMsgs

Um valor booliano que indica se ainda há mais mensagens sendo processadas. Se for TRUE, OnSmsReadComplete será chamado repetidamente até que não haja mais mensagens e moreMsgs seja FALSE.

[in] requestID

Uma ID de solicitação atribuída pelo serviço de Banda Larga Móvel para identificar a operação de leitura da mensagem.

[in] status

Um código status que indica o resultado da operação.

Um aplicativo de chamada pode esperar um dos valores a seguir.

Valor Significado
S_OK
 A operação foi bem-sucedida.
E_MBN_SIM_NOT_INSERTED
 Não há nenhum SIM no dispositivo.
E_MBN_BAD_SIM
 Há um SIM inválido no dispositivo.
E_MBN_PIN_REQUIRED
 Um PIN é necessário para que a operação seja concluída.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 A operação de SMS ou o formato SMS específico não são compatíveis com o dispositivo.
E_MBN_SMS_MEMORY_FAILURE
 Falha de memória sms.
E_MBN_SMS_INVALID_MEMORY_INDEX
 Não há nenhum índice de memória com o valor solicitado.
E_MBN_SMS_FILTER_NOT_SUPPORTED
 O dispositivo não dá suporte ao filtro solicitado.

Valor retornado

Esse método deve retornar S_OK.

Comentários

Para dispositivos GSM, o aplicativo de chamada deve chamar QueryInterface em cada elemento em readMsgs para uma interface IMbnSmsReadMsgPdu .

Para dispositivos CDMA, se smsFormat for MBN_SMS_FORMAT_TEXT, o aplicativo deverá chamar QueryInterface para uma interface IMbnSmsReadMsgTextCdma ; caso contrário, se smsFormat for MBN_SMS_FORMAT_PDU, o aplicativo deverá chamar QueryInterface para uma interface IMbnSmsReadMsgPdu .

Se uma solicitação de leitura resultar em uma grande quantidade de mensagens sendo lidas, OnSmsReadComplete poderá ser chamado repetidamente até que moreMsgs indique que não há mais mensagens a serem lidas.

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

Confira também

IMbnSmsEvents