PROPID_M_SENDERID_TYPE

The PROPID_M_SENDERID_TYPE property specifies the type of sender identifier found in PROPID_M_SENDERID.

Type Indicator

VT_UI4 (or VT_NULL)

PROPVARIANT Field

ulVal

Property Values

This property can have one of the following values:

MQMSG_SENDERID_TYPE_SID

The default. PROPID_M_SENDERID contains the SID of the user sending the message.

MQMSG_SENDERID_TYPE_NONE

No identifier is attached to the message.

Remarks

If the sending application does not want MSMQ to attach a sender identifier to a message, it can specify MQMSG_SENDERID_TYPE_NONE when passing PROPID_M_SENDERID_TYPE to MQSendMessage. This suppresses the message's PROPID_M_SENDERID property.

The receiving application can pass PROPID_M_SENDERID_TYPE to MQReceiveMessage to determine what type of sender identifier was attached to the message. The returned value for PROPID_M_SENDERID_TYPE can be one of the following:

• MQMSG_SENDERID_TYPE_NONE: No identifier was attached to the message.
• MQMSG_SENDERID_TYPE_SID: The sending user's SID was attached to the message.

When the receiving application specifies PROPID_M_SENDERID_TYPE, the corresponding VT field in the aPropVar array can be set to VT_NULL.

Local users (users not logged on to a Windows NT domain) cannot attach a SID to a message. The SID of a local user is only valid locally.

QuickInfo

  Windows NT: Requires version 4.0 SP3 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in mq.h.
  Import Library: Use mqrt.lib.
  Unicode: Defined only as Unicode.

See Also

MQReceiveMessage, MQSendMessage, PROPID_M_SENDERID