WTP_INVOKE (Windows Embedded CE 6.0)

1/6/2010

This structure defines the mechanism used for initiating a new transaction and indicating 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
    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 containing the sender's unique address.
  • dwSourcePort
    The port used by the sender.
  • waDestinationAddress
    A WAP_ADDRESS structure containing the destination address on a send operation. For receiving, this member remains blank.
  • dwDestinationPort
    The port used by the receiver.
  • bUserAcknowledgement
    FALSE if the Wireless Transaction Protocol 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 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*.*
  • 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
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

WAP_PRIMITIVE_ID
WAP_PRIMITIVE_BASE
WAP_PRIMITIVE_TYPE
WTP_TRANSACTION_CLASS_TYPE

Concepts

WAP Structures