Método IMbnSms::GetSmsStatus (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.
Obtém o sms status para um dispositivo.
Sintaxe
HRESULT GetSmsStatus(
[out] MBN_SMS_STATUS_INFO *smsStatusInfo
);
Parâmetros
[out] smsStatusInfo
Um ponteiro para uma estrutura MBN_SMS_STATUS_INFO, contendo as informações de status para o dispositivo.
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 sms status não está disponível. O serviço de Banda Larga Móvel está sondando o dispositivo para obter as informações. O aplicativo de chamada pode ser notificado quando o sms status está disponível registrando-se para o método OnSmsStatusChange da interface IMbnSmsEvents. |
|
Um PIN é necessário para obter essas informações. |
|
Um SIM não é inserido no dispositivo. |
|
Um SIM incorreto é inserido no dispositivo. |
Comentários
Para erros recuperáveis, como E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED e E_MBN_BAD_SIM, o serviço de Banda Larga Móvel consultará o dispositivo novamente para obter essas informações quando a condição de erro terminar. Por exemplo, se o dispositivo exigir que um PIN seja inserido para recuperar essas informações, ele retornará E_MBN_PIN_REQUIRED. Quando um aplicativo entra no PIN para desbloquear o dispositivo, o serviço de Banda Larga Móvel tentará novamente obter essas informações do dispositivo. O serviço de Banda Larga Móvel chamará o método OnSmsStatusChange da interface IMbnSmsEvents
O repositório de mensagens SMS status pode ser alterado devido à nova mensagem recebida pelo sistema. Em qualquer alteração no repositório de mensagens status, o serviço de Banda Larga Móvel chamará o método OnSmsStatusChange da interface IMbnSmsEvent.
Operações emitidas pelo aplicativo, como a leitura ou exclusão de mensagens, podem redefinir o sinalizador em MBN_SMS_STATUS_INFO estrutura. Uma alteração no repositório de SMS causada por essa redefinição não resultará na chamada de nenhum método de notificação.
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 |