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

Importante

A partir de 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 envio de mensagem.

Sintaxe

HRESULT OnSmsSendComplete(
  [in] IMbnSms *sms,
  [in] ULONG   requestID,
  [in] HRESULT status
);

Parâmetros

[in] sms

Uma interface IMbnSms que representa o dispositivo de Banda Larga Móvel do qual a operação foi concluída.

[in] requestID

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

[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)	Não há suporte para a operação de SMS ou o formato SMS específico do dispositivo.
E_MBN_SMS_MEMORY_FAILURE	Falha de memória sms.
E_MBN_SMS_UNKNOWN_SMSC_ADDRESS	Endereço do centro de serviço SMS desconhecido ou incompleto.
E_MBN_SERVICE_NOT_ACTIVATED	O serviço de celular não está ativado no dispositivo.
E_INVALIDARG	O dispositivo detectou parâmetros inválidos na solicitação de envio.
E_MBN_SMS_NETWORK_TIMEOUT	Houve um tempo limite de rede.
E_MBN_NOT_REGISTERED	O dispositivo não está registrado em nenhuma rede.
E_MBN_SMS_LANG_NOT_SUPPORTED	O dispositivo CDMA não dá suporte ao idioma.
E_MBN_SMS_ENCODING_NOT_SUPPORTED	O dispositivo CDMA não dá suporte à codificação solicitada.
E_MBN_SMS_OPERATION_NOT_ALLOWED	A operação de SMS solicitada não é permitida pelo SIM.
E_MBN_SMS_MEMORY_FULL	A memória do dispositivo/SIM está cheia.

Retornar valor

Esse método deve retornar S_OK.

Comentários

Uma operação de envio deve ser testada somente depois que o dispositivo for registrado com êxito na rede.

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

IMbnSmsEvents