[Cover] [Previous Section] [Next Section] [Index]
Current chapter: COM Notification Library Reference
Section 28 out of 79 total sections , Section 3 out of 5 sections in this chapter

Scalar types and definitions

This section defines enumerated types and manifest constants used in the COM library.

IMPORTANT     If you are calling COM library functions in Basic or C++ code, you can use the defined constants described below. With some other programming languages (such as Perl) and utilities (such as Cold Fusion), you can't use the defined constants. Instead, you must specify the actual values (which are also provided below).


Notification content types (ENtfnType)

The following enumerated constants specify notification content types. See the UP.SDK Developer's Guide for a description of notification and notification content types.

Constant  Value  Description 
CNtfnTypePrefetch  
 1  

A prefetch (pull) notification.  

CNtfnTypeAlert  
 2  

An alert 

CNtfnTypeCacheOp  
 3  

A cache operation 

CNtfnTypeNone  
 0  

A dummy, invalid type, which you can use for catching errors. 


Notification status codes (ENtfnStatus)

The following enumerated constants specify notification status codes returned by the UP.Link server in response to NtfnGetNtfnStatus, NtfnGetPrefetchStatus, and NtfnGetAlertStatus calls..

Constant  Value  Description 
CNtfnStatusPending  
 1  

Notification in process of being delivered  

CNtfnStatusDelivered  
 2  

Notification was delivered to phone  

CNtfnStatusExpired  
 3  

Notification expired (exceeded the notification's TTL) 

CNtfnStatusUndeliverable  
 4  

Notification could not be delivered  

CNtfnStatusNone  
 0  

A dummy, invalid status type, which you can use for catching errors. 


Port numbers

The following constants specify the IANA-assigned port numbers for secure and non-secure notifications.

Constant  Value  Description 
CUpnotifypsPort  
 3356  

The upnotifyps (secure) port 

CUpnotifypPort  
 4445  

The upnotifyp (non-secure) port 


HTTP status codes

The following constants specify HTTP status codes. The meaning of these codes varies slightly, depending on which method returns them. See the sections for the methods that return these code for complete descriptions..

Constant  Value  Description 
CHTTPStatusOK  
 200  

HTTP status code 200 

CHTTPStatusNoContent  
 204  

HTTP status code 204 

CHTTPStatusBadRequest  
 400  

HTTP status code 400 

CHTTPStatusForbidden  
 403  

HTTP status code 403 

CHTTPStatusNotFound  
 404  

HTTP status code 404 

CHTTPStatusSvcUnavail  
 503  

HTTP status code 503 

For more information on HTTP status codes, see the following RFC:

IMPORTANT     If a notification call returns a -1 error value, this indicates a general I/O failure has occured. The most common cause of this error is that a corporate firewall is blocking the destination notification port.


Notification protocols

The following constants specify the notification protocols used by the Notification API.

Constant  Value  Description 
CNtfnProtoUpnotifyps  
 2  

upnotifyps (HTTPS-based) protocol 

CNtfnProtoUpnotifyp  
 1  

upnotifyp (HTTP-based) protocol 

CNtfnProtoNone  
 0  

The protocol is unknown. 

[Cover] [Previous Section] [Next Section] [Index]
Current chapter: COM Notification Library Reference
Section 28 out of 79 total sections , Section 3 out of 5 sections in this chapter

Copyright © 1999, Unwired Planet, Inc. All rights reserved.