Share via


MSMQApplication.Machine

 

Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista

(Introduced in MSMQ 3.0.) The Machine property of the MSMQApplication object sets or returns the name of the computer to which the MSMQApplication object refers.

Data type: String
Run-time access: Read-write
Property Machine As String  

Property Value

A String that contains the name of the computer. The string can contain the NETBIOS name, the DNS name, or the IP address of the computer.

Error Codes

For information on return codes, see Message Queuing Error and Information Codes.

Remarks

Including the MSMQApplication object in the code syntax is optional because this object is defined as the application object, whose methods and properties are globally available.

By default, the MSMQApplication object refers to the local computer. This property can be used to change which computer the MSMQApplication object refers so that an application can inspect the properties of other computers. For example, if this property is set to a remote computer the MSMQApplication.ActiveQueues property will return all the active queues on the remote computer.

In C++ COM applications, you must use a smart pointer to the IMSMQApplication3 interface to expose the Machine property.

Requirements

Windows NT/2000/XP: Included in Windows XP and Windows Server 2003.

Windows 95/98/Me: Unsupported.

Header: Declared in Mqoai.h.

Library: Use Mqoa.lib.

See Also

MSMQApplication
MSMQApplication.ActiveQueues