Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure represents the primitive type from which all other primitive types are derived. This structure passes primitive type and field information in WapSendand WapReadcalls.

Syntax 

typedef struct wap_primitive_base_tag{
  WAP_PRIMITIVE_ID 
wpiPrimitiveID;
  WAP_PRIMITIVE_TYPE 
wptPrimitiveType;
  DWORD 
dwValidFields;
} WAP_PRIMITIVE_BASE;

Members

wpiPrimitiveID

The primitive identifier. Possible values are any of the values defined for the WAP_PRIMITIVE_IDenumeration. Applications will cast the base structure according to this identifier. It is always present and valid.

wptPrimitiveType

The primitive type. Possible values are any of the values defined for the WAP_PRIMITIVE_TYPEenumeration.

dwValidFields

Bitmask that indicates the valid fields in the primitive, dependent on the value of wpiPrimitiveID. Possible values are listed in the following table.

Value Description

WDP_FIELD_NONE

No fields are valid.

WDP_FIELD_SOURCEADDRESS

The address of the device sending the WDP datagram.

WDP_FIELD_SOURCEPORT

The source port for the WDP datagram.

WDP_FIELD_DESTINATIONADDRESS

The address of the device receiving the WDP datagram.

WDP_FIELD_DESTINATIONPORT

The destination port for the WDP datagram.

WDP_FIELD_USERDATA

The byte array of user data being sent.

WTP_FIELD_NONE

No fields are valid.

WTP_FIELD_SOURCEADDRESS

The address of the device sending the WTP datagram.

WTP_FIELD_SOURCEPORT

The source port for the WTP datagram.

WTP_FIELD_DESTINATIONADDRESS

The address of the device receiving the WTP datagram.

WTP_FIELD_DESTINATIONPORT

The destination port for the WTP datagram.

WTP_FIELD_USERACKNOWLEDGEMENT

The status of the WTP user acknowledgement feature (on or off).

WTP_FIELD_WANTSECURETRANSACTION

If set, specifies that the WTP transaction should send and receive datagrams with enhanced security through the Wireless Transport Layer Security (WTLS) layer.

WTP_FIELD_USERDATA

The byte array of user data being sent.

WTP_FIELD_CLASSTYPE

The transaction class type.

WTP_FIELD_EXITINFO

Byte array of user data to be sent to the sender when the transaction is complete.

WTP_FIELD_HANDLE

A unique transaction identifier that is used to track a single WTP transaction.

WTP_FIELD_ABORTCODE

The reason a transaction was stopped.

Requirements

Header wap.h
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also