Share via

MSMQMessage.SourceMachineGuid (Compact 2013)

  • Article

3/26/2014

This read-only property provides the identifier of the source computer that sent the message.

Syntax

HRESULT get_SourceMachineGuid( 
  BSTR* pbstrGuidSrcMachine 
);

Parameters

  • pbstrGuidSrcMachine
    String that includes the GUID of the source computer.

Return Value

The following table describes the common return values.

Value

Description

S_OK

Success

E_INVALIDARG

One or more arguments are invalid

E_NOTIMPL

The function contains no implementation

E_OUTOFMEMORY

Out of memory

Remarks

MSMQMessage.SourceMachineGuid can be used by the receiving application when it needs to know the identifier of the computer that sent the message.

Format of returned identifier

The string returned by this property does not include the braces normally used with GUIDs. The format of the source machine GUID string is as follows.

12345678-1234-1234-1234-123456789012

Null characters in strings

Message Queuing COM components ignore characters that follow the first Null character in a string without returning an error.

Equivalent Function property

When using functions, the identifier of the source computer can be set and retrieved using the PROPID_M_SRC_MACHINE_ID property.

Requirements

Header

mqoai.h

Library

mqoa.lib

See Also

Reference

MSMQMessage
PROPID_M_SRC_MACHINE_ID