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

Atualizações a configuração de SMS para um dispositivo.

Sintaxe

HRESULT SetSmsConfiguration(
  [in]  IMbnSmsConfiguration *smsConfiguration,
  [out] ULONG                *requestID
);

Parâmetros

[in] smsConfiguration

Uma interface IMbnSmsConfiguration que representa a nova configuração de SMS com a qual atualizar o dispositivo.

[out] requestID

Um ponteiro para uma ID de solicitação emitida pelo serviço de Banda Larga Móvel para identificar essa solicitação.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	O serviço de Banda Larga Móvel não está em execução no sistema.
E_HANDLE	A interface é inválida, provavelmente porque o dispositivo foi removido do sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	A interface é inválida. Provavelmente, o dispositivo de Banda Larga Móvel foi removido do sistema.

Comentários

Um aplicativo pode usar SetSmsConfiguration para modificar o endereço padrão da Central de Serviços de SMS no dispositivo.

Um aplicativo deve executar as etapas a seguir para definir a configuração de SMS do dispositivo.

1. Obtenha uma interface IMbnSmsConfiguration chamando GetSmsConfiguration.
2. Modifique a interface IMbnSmsConfiguration obtida da etapa 1 com os novos valores que refletem as alterações desejadas na configuração..
3. Passe o IMbnSmsConfiguration modificado para SetSmsConfiguration.

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 OnSetSmsConfigurationComplete da interface IMbnSmsEvents .

Requisitos

Requisito	Valor
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

IMbnSmsConfiguration