PushRouter_Open
.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 hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
9/19/2008
Essa função abrirá uma canalizar de comunicação para passar as enviar mensagens para o cliente roteador enviar.
Syntax
HRESULT PushRouter_Open(
LPCTSTR szContentType,
LPCTSTR szAppId,
HANDLE* pMsgAvailableEvent,
HPUSHROUTER* phPushRouter
);
Parameters
szContentType
[no] Ponteiro para o tipo de conteúdo da mensagem encaminhada para o cliente roteador enviar. O tipo é designado em um cabeçalho mensagem que identifica o cliente roteador enviar na tabela registro roteador a enviar.Observação
Para obter detalhes sobre o cabeçalho Content-Type, referir ao WAP Specification "WAP-251-PushMessage-20010322-a.PDF" Nesta OMA Web site.
szAppId
[no] Ponteiro para o aplicativo enviar identificação do cliente de roteador enviar. A identificação é designada em um cabeçalho mensagem que identifica o cliente roteador enviar na tabela registro roteador a enviar.Observação
Para obter detalhes sobre o Push Application ID, referir ao WAP Specification "WAP-251-PushMessage-20010322-a.PDF" Nesta OMA Web site.
- pMsgAvailableEvent
[out] Ponteiro para um sinalizador que sinaliza o cliente roteador enviar quando uma mensagem está disponível.
- phPushRouter
[out] Ponteiro para um identificador para o roteador enviar.
Return Value
Retorna S_OK se bem-sucedido. Se a função for malsucedido, ele poderá retornar um padrão Windows HRESULT valor ou uma dos enviar específicas roteador HRESULT valores mostrados na seguinte tabela.
| Valor | Descrição |
|---|---|
PUSHRTR_E_ALREADYOPENED |
Outro cliente já está aberto com a mesma combinação aplicativo identificação e tipo de conteúdo. |
PUSHRTR_E_EXCEPTION |
Uma exceção ocorreu na função de roteador enviar. |
PUSHRTR_E_NOTFOUND |
Nenhum registro existe para o cliente a ser aberto ou registro cancelado. |
Remarks
Fazer não chamar o CloseHandle função com o identificador mensagem recuperada por PushRouter_Open.
Requirements
| Header | pushclient.h |
| Library | Pushprxy.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later |
| Windows Mobile | Pocket PC for Windows Mobile 2003 and later, Smartphone for Windows Mobile 2003 and later |