Compartilhar via

Método IMbnSms::GetSmsConfiguration (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.

Obtém a configuração de SMS de um dispositivo.

Sintaxe

HRESULT GetSmsConfiguration(
  [out, retval] IMbnSmsConfiguration **smsConfiguration
);

Parâmetros

[out, retval] smsConfiguration

Uma interface IMbnSmsConfiguration que representa a configuração de SMS do dispositivo.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 O método foi concluído com sucesso.
E_PENDING
 A configuração de SMS 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 a configuração de SMS está disponível registrando-se para o método OnSmsConfigurationChange da interface IMbnSmsEvents .
E_MBN_PIN_REQUIRED
 Um PIN é necessário para obter essas informações.
E_MBN_SIM_NOT_INSERTED
 Não há nenhum SIM no dispositivo.
E_MBN_BAD_SIM
 Há um SIM inválido no dispositivo.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 Não há suporte para SMS 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 fosse inserido para recuperar essas informações, ele retornará E_MBN_PIN_REQUIRED. Quando um aplicativo insere o 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 OnSmsConfigurationChange da interface IMbnSmsEvents

A configuração de SMS pode ser atualizada pela rede ou pelo dispositivo sem qualquer solicitação de alteração por qualquer aplicativo. Nesse caso, o serviço de Banda Larga Móvel notificará todos os aplicativos registrados chamando o método OnSmsConfigurationChange 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

Confira também

IMbnSms