PushRouter_Open
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
);
Parameters
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.Note For details about the Content-Type header, refer to WAP Specification "WAP-251-PushMessage-20010322-a.pdf" at this OMA website/.
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.Note For details about the Push Application ID, refer to WAP Specification "WAP-251-PushMessage-20010322-a.pdf" at this OMA website/.
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.
Return Values
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. |
Remarks
Do not call the CloseHandle function with the message handle retrieved by PushRouter_Open.
Requirements
Pocket PC: Windows Mobile 2003 and later
Smartphone: Windows Mobile 2003 and later
OS Versions: Windows CE .NET 4.2 and later
Header: Pushclient.h.
Library: Pushprxy.lib.
See Also
Send Feedback on this topic to the authors