See Also
 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
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.SourceMachineGuidcan 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.
 Copy Code
|
|
|---|---|
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_IDproperty.
Requirements
| Header | mqoai.h |
| Library | mqoa.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |