SmsOpen
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/19/2008
Use esta função para aberto o componente Short Message Service (SMS) mensagens para enviar e / ou receber acessar. Se o provedor especificado não é possível suporte a ação solicitada (ler ou gravação), e a chamar para SmsOpen retornará um erro.
Syntax
HRESULT SmsOpen (
const LPCTSTR ptsMessageProtocol,
const DWORD dwMessageModes,
const SMS_HANDLE* psmshHandle,
const HANDLE* phMessageAvailableEvent);
Parameters
- ptsMessageProtocol
Aponta para um seqüência de caracteres que indica qual protocolo do SMS para usar.
dwMessageModes
O envio e / ou receber modo. Este parâmetro pode ser qualquer combinação dos seguinte valores:Valor Descrição SMS_MODE_RECEIVE
Recebe modo.
SMS_MODE_SEND
Envie modo.
- psmshHandle
Se SmsOpen Retorna com êxito, que esse parâmetro é um identificador do SMS para os comandos subseqüentes Read/Write.
- phMessageAvailableEvent
Identificador evento A Microsoft® Win32® que está sinalizado quando uma nova mensagem é disponível seja ler. Aplicativos podem esperar neste identificador por chamado Win32 APIs adequado (WaitForSingleObject, MsgWaitForMultipleObjectse SO on), mas deve Não usar este identificador com qualquer outro APIs (SetEvent, ResetEvent e assim por diante). Fazer não chamar CloseHandle neste identificador evento (essa tarefa será executada por SmsClose).
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.
Remarks
Vários clientes pode aberto um identificador do SMS para enviar um tipo mensagem SMS específico, mas somente um cliente pode ter um identificador aberto para leitura em um tempo. O identificador evento criado pelo chamar função deve ser aguardou em somente — fazer não chamar qualquer outras funções evento no identificador evento. Identificador de evento será fechada no chamado SmsClose. Comportamento está indefinido se o usuário destrói este evento instead of SmsClose.
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 |