Export (0) Print
Expand All

MSMQApplication

The MSMQApplication object provides methods and properties that can be used to obtain information about the Message Queuing service on a computer. This object can be used to do the following:

  • Connect a computer to or disconnect a computer from the network.

  • Register a certificate in Active Directory Domain Services (AD DS).

  • Obtain the name or globally unique identifier (GUID) of a specified computer.

  • Clean up empty message files on a computer.

  • Obtain information about the Message Queuing installation on a computer.

ms703173.note(en-us,VS.85).gifNote
Creating a new instance of this object does not start a new instance of the Message Queuing service.

Methods

The MSMQApplication object defines the following methods.

Method Description

MSMQApplication.Connect

(Introduced in MSMQ 3.0.) Connects the computer to the network and the directory service server.

MSMQApplication.Disconnect

(Introduced in MSMQ 3.0.) Disconnects the computer from the network and the directory service server.

MSMQApplication.MachineIdOfMachineName

Returns the globally unique identifier (GUID) for a specified computer.

MSMQApplication.MachineNameOfMachineId

(Introduced in MSMQ 2.0.) Returns the name of a computer specified by its globally unique identifier (GUID).

MSMQApplication.RegisterCertificate

(Introduced in MSMQ 2.0.) Registers an external or internal certificate in the directory service.

MSMQApplication.Tidy

(Introduced in MSMQ 3.0.) Cleans up empty message files on a computer.

Properties

The MSMQApplication object defines the following properties.

Property Description

MSMQApplication.ActiveQueues

(Introduced in MSMQ 3.0.) Returns the format names of all active queues on the computer.

Run-time access: Read-only

Data type: Variant (array of variants)

MSMQApplication.BytesInAllQueues

(Read-only, introduced in MSMQ 3.0.) Returns the number of message bytes currently stored in all queues on the computer.

Run-time access: Read-only

Data type: Variant

MSMQApplication.DirectoryServiceServer

(Introduced in MSMQ 3.0.) Returns the name of the current directory service server.

Run-time access: Read-only

Data type: Variant (String)

MSMQApplication.IsConnected

(Introduced in MSMQ 3.0.) Returns a Boolean equal to False (0) if the queue manager on the computer has been disconnected from the network by Disconnect, by the equivalent API function, or by taking Message Queuing offline in the user interface and will not attempt to connect to the network and access the directory service.

Run-time access: Read-only

Data type: Boolean

MSMQApplication.IsDSEnabled

(Introduced in MSMQ 2.0.) Indicates whether Message Queuing is configured to use the directory service.

Run-time access: Read-only

Data type: Boolean

MSMQApplication.Machine

(Introduced in MSMQ 3.0.) Sets or returns the name of the computer to which the MSMQApplication object refers.

Run-time access: Read-write

Data type: String

MSMQApplication.MSMQVersionBuild

(Introduced in MSMQ 2.0.) Returns the build number of the version of Message Queuing that is installed on the computer.

Run-time access: Read-only

Data type: Integer

MSMQApplication.MSMQVersionMajor

(Introduced in MSMQ 2.0.) Returns the major version of Message Queuing that is installed on the computer.

Run-time access: Read-only

Data type: Integer

MSMQApplication.MSMQVersionMinor

(Introduced in MSMQ 2.0.) Returns the minor version of Message Queuing that is installed on the computer.

Run-time access: Read-only

Data type: Integer

MSMQApplication.PrivateQueues

(Introduced in MSMQ 3.0.) Returns the path names of all private queues registered on the computer.

Run-time access: Read-only

Data type: Variant (array of variants)

Remarks

Because MSMQApplication is a COM application object, you do not have to explicitly reference MSMQApplication when calling the methods and properties provided by the object. For example, the following three calls to MSMQApplication.MachineIdOfMachineName all return the same computer GUID.

Dim strId As String
Dim myapp As New MSMQApplication

strId = MachineIdOfMachineName("machinename")
Debug.Print strId

strId = MSMQApplication.MachineIdOfMachineName("machinename")
Debug.Print strId

strId = myapp.MachineIdOfMachineName("machinename")
Debug.Print strId

Requirements

Windows NT/2000/XP: Included in Windows NT 4.0 SP3 and later.

Windows 95/98/Me: Included in Windows 95 and later.

Header: Declared in Mq.h.

Library: Use Mqoa.lib.

See Also

Show:
© 2014 Microsoft