WTP_INVOKE

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/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*.*

• 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

See Also

Reference

WAP_PRIMITIVE_ID
WAP_PRIMITIVE_BASE
WAP_PRIMITIVE_TYPE
WTP_TRANSACTION_CLASS_TYPE

Concepts

WAP Structures