Compartilhar via

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

Envia uma mensagem no formato PDU.

Sintaxe

HRESULT SmsSendPdu(
  [in]  LPCWSTR pduData,
  [in]  BYTE    size,
  [out] ULONG   *requestID
);

Parâmetros

[in] pduData

Uma cadeia de caracteres que representa a mensagem PDU no formato hexadecimal.

[in] size

O tamanho da mensagem PDU em número de bytes antes de converter em formato de cadeia de caracteres hexadecimal e excluir o comprimento do endereço do centro de serviço.

[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.
E_INVALIDARG
 pduData ou tamanho são inválidos.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 O serviço de Banda Larga Móvel não está em execução neste 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.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 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 CDMA.

Comentários

Esses dados em pduData são compatíveis com a estrutura PDU definida em 3GPP TS 27.005 e 3GPP TS 23.040.

A tabela a seguir mostra um exemplo de como uma mensagem PDU que contém a mensagem "Hello" seria estruturada.

Exemplo 07 91198994000010 11000A9189945086180000AA05C8329BFD06
Sumário Tamanho do endereço da Central de Serviços Endereço da Central de Serviços PDU no formato hexadecimal
Tamanho 1 byte Variável Variável
 

Essa função deve ser chamada apenas para dispositivos GSM que dão suporte ao envio de SMS no formato PDU. Um dispositivo relata essa capacidade definindo MBN_SMS_CAPS_PDU_SEND em MBN_INTERFACE_CAPS.

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

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