PushRouter_Open

Windows Mobile 6.5
4/8/2010

This function opens a communication channel for passing the push messages to the push router client.


HRESULT PushRouter_Open(
  LPCTSTR szContentType,
  LPCTSTR szAppId,
  HANDLE* pMsgAvailableEvent,
  HPUSHROUTER* phPushRouter
);

szContentType

[in] Pointer to the content type of the message routed to the push router client. The type is designated in a message header that identifies the push router client in the push router registration table.

Bb416258.note(en-us,MSDN.10).gifNote:
For details about the Content-Type header, refer to WAP Specification "WAP-251-PushMessage-20010322-a.pdf" at this OMA Web site.
szAppId

[in] Pointer to the push application ID of the push router client. The ID is designated in a message header that identifies the push router client in the push router registration table.

Bb416258.note(en-us,MSDN.10).gifNote:
For details about the Push Application ID, refer to WAP Specification "WAP-251-PushMessage-20010322-a.pdf" at this OMA Web site.
pMsgAvailableEvent

[out] Pointer to a flag that signals the push router client when a message is available.

phPushRouter

[out] Pointer to a handle to the push router.

Returns S_OK if successful. If the function is unsuccessful, it can return a standard Windows HRESULT value or one of the push router-specific HRESULT values shown in the following table.

Value Description

PUSHRTR_E_ALREADYOPENED

Another client is already opened with the same application ID and content type combination.

PUSHRTR_E_EXCEPTION

An exception occurred in the push router function.

PUSHRTR_E_NOTFOUND

No registration exists for the client to be opened or unregistered.

Do not call the CloseHandle function with the message handle retrieved by PushRouter_Open.

Headerpushclient.h
LibraryPushprxy.lib
Windows Embedded CEWindows CE .NET 4.2 and later
Windows MobilePocket PC for Windows Mobile 2003 and later, Smartphone for Windows Mobile 2003 and later

Community Additions

Show: