SmsGetMessageStatus

9/19/2008

Use esta função para recuperar um relatório status de uma mensagem enviada com o sinalizador PS_MESSAGE_OPTION_STATUSREPORT. Consulte comentários para obter mais detalhes.

Syntax

HRESULT SmsGetMessageStatus (
    const SMS_HANDLE         smshHandle,
    SMS_MESSAGE_ID           smsmidMessageID,
  SMS_STATUS_INFORMATION*  psmssiStatusInformation,
    const DWORD              dwTimeout
);

Parameters

• smshHandle
  Um identificador Short Message Service (SMS) obtida chamado SmsOpen.

• smsmidMessageID
  Essa é uma mensagem identificação retornada por SmsSendMessage.

• psmssiStatusInformation
  Contém o real informações status mensagem se o API retornado com êxito.

• dwTimeout
  O tempo limite (em milissegundos) para aguardar a mensagem status a ser recebida (se ele não já foi recebido).

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.

Remarks

Se a mensagem enviada originalmente resultou em um SMS multiparte, um relatório Único status será disponível depois que um relatório tiver sido recebido para cada mensagem com diversas partes. Consulte a descrição da estrutura SMS_STATUS_INFORMATION para obter mais detalhes a respeito um relatório status mensagem com diversas partes.

Há dois métodos para obter um relatório status. Uma maneira é registrar para mensagens relatório status, assim como qualquer outro tipo mensagem Provider-specific. No entanto, isso só permite uma entidade para receber mensagens status. A segunda maneira é usar a função SmsGetMessageStatus. Isso permite que qualquer entidade para ler a mensagem status, se ela tiver o correspondente identificador mensagem do original mensagem. Ao contrário das outra de entrada mensagens, status mensagens persistir até que a reserva mensagem status esteja completa. Em seguida, mensagens de status mais antigas são sobrescritas. Isso significa múltiplo aplicativos podem receber informações mensagem status.

Usando dwTimeout Para aguardar o status mensagem a ser recebida permite que um aplicativo para chamar SmsGetMessageStatus Imediatamente após chamado SmsSendMessage.

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
SmsSendMessage
SMS_STATUS_INFORMATION
SmsGetMessageStatus

Concepts

Short Message Service Functions