WTP_INVOKE (Compact 2013)

3/26/2014

This structure defines the mechanism used to initiate a new transaction and to indicate that a new transaction has been initiated. For more information, see WAP-201 specification "Wireless Transaction Protocol (WTP)."

Syntax

typedef struct wtp_invoke_tag{
  WAP_PRIMITIVE_ID wpiPrimitiveID;
  WAP_PRIMITIVE_TYPE wptPrimitiveType;
  DWORD dwValidFields;
  WAP_ADDRESS waSourceAddress;
  DWORD dwSourcePort;
  WAP_ADDRESS waDestinationAddress;
  DWORD dwDestinationPort;
  BOOL bUserAcknowledgement;
  BOOL bWantSecureTransaction;
  const BYTE* pbUserData;
  DWORD dwUserDataSize;
  WTP_TRANSACTION_CLASS_TYPE wtctClassType;
  const BYTE* pbExitInfo;
  DWORD dwExitInfoSize;
  WTP_TRANSACTION_HANDLE wthTransactionHandle;
} WTP_INVOKE;

Members

• wpiPrimitiveID
  The primitive identifier. The only possible value is WAP_PRIMITIVE_ID_TR_INVOKE, as defined by the WAP_PRIMITIVE_ID enumeration. 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_TYPE enumeration.

• dwValidFields
  The bitmask that indicates the valid fields in the primitive, dependent on the value of wpiPrimitiveID. For possible values, see WAP_PRIMITIVE_BASE.

• waSourceAddress
  A WAP_ADDRESS structure that contains the sender's unique address.

• dwSourcePort
  The port used by the sender.

• waDestinationAddress
  A WAP_ADDRESS structure that contains the destination address on a send operation. For receiving, this member remains blank.

• dwDestinationPort
  The port used by the receiver.

• bUserAcknowledgement
  FALSE if the WTP layer will automatically issue acknowledgements. If this member is set to TRUE, acknowledgements will not be sent until the WTP clients have actually received the primitives. For more information, see the "Remarks" section of this topic.

• bWantSecureTransaction
  TRUE if the WTP transaction should be passed through Wireless Transport Layer Security (WTLS) as a transaction with enhanced security. If this member is set to FALSE or is unspecified, an unsecured transaction is assumed.

• pbUserData
  Pointer to the datagram that is being sent.

• dwUserDataSize
  The number of bytes in the datagram indicated by pbUserData.

• wtctClassType
  The type of WTP transaction. For possible values, see the WTP_TRANSACTION_CLASS_TYPE enumeration.

• pbExitInfo
  Pointer to additional user data to be sent to the sender when the transaction is complete.

• dwExitInfoSize
  Size, in bytes, of the buffer indicated by pbExitInfo.

• wthTransactionHandle
  A handle that identifies the transaction that is being initiated. See WTP_TRANSACTION_HANDLE.

Requirements

Header

wap.h

See Also

Reference

WAP Structures
WTP_TRANSACTION_HANDLE
WAP_PRIMITIVE_ID
WAP_PRIMITIVE_BASE
WAP_PRIMITIVE_TYPE
WTP_TRANSACTION_CLASS_TYPE
WAP_ADDRESS