SmsSendMessage

9/19/2008

Essa função cria e envia uma mensagem Short Message Service (SMS).

Syntax

HRESULT SmsSendMessage (
    const SMS_HANDLE   smshHandle,
    const SMS_ADDRESS* psmsaSMSCAddress,
    const SMS_ADDRESS* psmsaDestinationAddress,
    const SYSTEMTIME*  pstValidityPeriod,
    const BYTE*        pbData,
    const DWORD        dwDataSize,
    const BYTE*        pbProviderSpecificData,
    const DWORD        dwProviderSpecificDataSize,
    const SMS_DATA_ENCODING smsdeDataEncoding,
    const DWORD        dwOptions,
  SMS_MESSAGE_ID*    psmsmidMessageID
);

Parameters

• smshHandle
  Um identificador do SMS obtida chamado SmsOpen.

• psmsaSMSCAddress
  Um opcional parâmetro indicando que Short Message Service Center (SMSC) a mensagem será roteada através de. Se NULL (recomendado), usar como padrão do usuário SMSC será usado.

• psmsaDestinationAddress
  O destino da mensagem.

• pstValidityPeriod
  A duração para o qual a mensagem do SMS é válido, contados a partir quando o SMSC recebe a mensagem. Isso pode ser NULL. Isso não é interpretado como um normal SYSTEMTIME estrutura. Consulte GSM especificação 03.40 "digital telecomunicações celular sistema (fase 2+); Técnica realização do serviço a mensagem curta (SMS)" Para obter mais detalhes.

• pbData
  O parte de dados da mensagem. Isso pode ser NULL.

• dwDataSize
  Tamanho em Bytes da reserva apontado pelo pbData. Isso pode ser zero.

• pbProviderSpecificData
  Para determinados provedores, uma estrutura Provider-specific deve ser fornecida in addition to a reserva dados anteriores.

• dwProviderSpecificDataSize
  Tamanho de pbProviderSpecificData.

• smsdeDataEncoding
  O codificação de texto da mensagem do SMS, se apropriado. SMSDE_OPTIMAL é o valor recomendado. Consulte a enumeração SMS_DATA_ENCODING para valores possíveis.

• dwOptions
  Sinalizadores opcionais.

  Valor	Descrição
  SMS_OPTION_DELIVERY_NONE	Não há opções especiais
  SMS_OPTION_DELIVERY_NO_RETRY	A menos que essa opção é especificada, o roteador tentará enviar a mensagem SMS de acordo com uma cronograma de repetição de curto prazo predefinidos. Se esta opção for especificada, nenhuma tentativas serão tentadas.

• psmsmidMessageID
  Se não for NULL, este irá apontar para uma mensagem identificação no bem-sucedido de retorno de SmsSendMessage. Esse identificador pode ser usado com SmsGetMessageStatus para identificar a mensagem.

Return Value

Esse método retorna o padrão valores E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, e E_FAIL, as well as o seguinte:

• S_OK
  O método foi concluído com êxito.

Para obter informações sobre valores de retorno adicionais, consulte Erros específicos do SMS e Erros gerais do SMS.

Requirements

Header	sms.h
Library	sms.lib
Windows Embedded CE	Windows Embedded CE 6.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

SmsOpen
SMS_DATA_ENCODING
SmsGetMessageStatus

Concepts

Short Message Service Functions