Método IMbnSms::SmsSendCdma (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.
Envia uma mensagem no formato CDMA.
Sintaxe
HRESULT SmsSendCdma(
[in] LPCWSTR address,
[in] MBN_SMS_CDMA_ENCODING encoding,
[in] MBN_SMS_CDMA_LANG language,
[in] ULONG sizeInCharacters,
[in] SAFEARRAY *message,
[out] ULONG *requestID
);
Parâmetros
[in] address
Uma cadeia de caracteres terminada em nulo que contém o número de telefone do receptor. O tamanho máximo da cadeia de caracteres é de 15 dígitos.
[in] encoding
Um valor MBN_SMS_CDMA_ENCODING que especifica a codificação de dados.
[in] language
Um valor MBN_SMS_CDMA_LANG que especifica o idioma.
[in] sizeInCharacters
O número de caracteres codificados na mensagem. Isso pode ser diferente do tamanho da matriz de mensagens.
[in] message
Uma matriz de bytes que contém a mensagem CDMA codificada.
O tamanho máximo dessa matriz é a propriedade CdmaShortMsgSize de IMbnSmsConfiguration, no entanto, isso não pode ser maior que MBN_CDMA_SHORT_MSG_SIZE_MAX (160).
[out] requestID
Um ponteiro para uma ID de solicitação emitida pelo serviço de Banda Larga Móvel para identificar essa solicitação.
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 serviço de Banda Larga Móvel não está em execução neste sistema. |
|
A interface é inválida, provavelmente porque o dispositivo foi removido do sistema. |
|
A interface é inválida. Provavelmente, o dispositivo de Banda Larga Móvel foi removido do sistema. |
|
O dispositivo não dá suporte ao envio de mensagens SMS no formato solicitado. Por exemplo, se essa função for chamada para um dispositivo GSM. |
Comentários
Esse método pode ser usado para enviar uma mensagem SMS para um dispositivo CDMA. No entanto, isso ocorre somente quando o dispositivo CDMA dá suporte ao envio de SMS. Um aplicativo de chamada pode saber se o dispositivo dá suporte a esse formato chamando o método GetInterfaceCapability de IMbnInterface. Em seguida, ele pode procurar MBN_SMS_CAPS_TEXT_SEND no membro smsCaps do MBN_INTERFACE_CAPS.
O parâmetro address pode estar em qualquer um desses formatos.
- "+ <Número da Central> de Serviços sms de código><de país internacional\0"
- "<Número da> Central de Serviços de SMS\0"
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 OnSmsSendComplete 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 |