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*.*
- 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 |
| 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