Share via


MSMQMessage.SourceMachineGuid (Windows Embedded CE 6.0)

1/6/2010

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.

Ee501145.collapse(en-US,WinEmbedded.60).gifFormat 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

Ee501145.collapse(en-US,WinEmbedded.60).gifNull characters in strings

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

Ee501145.collapse(en-US,WinEmbedded.60).gifEquivalent 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
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

MSMQMessage
PROPID_M_SRC_MACHINE_ID