System.Messaging

Specifies access rights for a trustee (user, group, or computer) to perform application-specific implementations of common tasks.

Initializes a new instance of the class that specifies neither a trustee nor set of rights to apply.

Initializes a new instance of the class that specifies a trustee to which rights are granted or denied.

A that specifies a user, group, computer, domain, or alias. The parameter is null.

Initializes a new instance of the class that specifies a trustee, rights to assign, and whether to grant or deny these rights.

A that specifies a user, group, computer, domain, or alias. A bitwise combination of the values. A bitwise combination of the values. One of the values, which specifies whether to allow, deny, set, or revoke the specified rights. The parameter is null. The , , or parameters are not valid enumeration values.

Gets or sets custom access rights.

Application-specific access rights, usually defined as a bitflag.

Gets or sets a value that indicates how the access rights apply to the trustee.

One of the values, which specifies whether to allow, deny, set, or revoke the specified rights. The default is Allow. The entry type is not a valid enumeration value.

Gets or sets a set of common access rights that map to both standard and object-specific access rights for reading, writing, and executing.

A bitwise combination of the values. The value you set is not a valid combination of bitflag members.

Gets or sets a set of standard access rights that correspond to operations common to most types of securable objects.

A bitwise combination of the values. The value you set is not a valid combination of bitflag members.

Gets or sets the user, group, domain, or alias to which you are assigning access rights.

A that specifies a user account, group account, or logon session to which a applies. The property is null.

Specifies whether to allow, deny, or revoke access rights for a trustee.

An access-allowed entry that causes the new rights to be added to any existing rights the trustee has.

An access-allowed entry that is similar to Allow, except that the new entry allows only the specified rights. Using it discards any existing rights, including all existing access-denied entries for the trustee.

An access-denied entry that denies the specified rights in addition to any currently denied rights of the trustee.

An entry that removes all existing allowed or denied rights for the specified trustee.

Contains a list of access control entries, specifying access rights for one or more trustees.

Initializes a new instance of the class.

Appends an access control entry to the access control list.

The position into which the new access control entry was inserted. A to append to the end of the access control list. The parameter is null.

Determines whether the access control list contains a specific access control entry.

true if the access control entry is found in the access control list; otherwise, false. The to locate in the access control list.

Copies the entire access control list to a compatible one-dimensional array of access control entries, starting at the specified index of the target array.

An array of type to which the access control list entries will be copied. The array must have zero-based indexing. The index in the array at which to begin copying the access control list entries. The parameter is null. The parameter is less than zero. The parameter is greater than or equal to the length of the parameter.-or-The number of elements in the source access control list is greater than the available space from to the end of the destination array of access control entries.

Determines the specific index of an access control entry in the access control list.

The index of the entry if it was found in the list; otherwise, -1 The to locate in the access control list.

Inserts an access control entry into the access control list at the specified position.

The zero-based index at which the access control entry should be inserted. A to insert into the access control list. The parameter is not a valid index in this access control list. The parameter is null.

Removes the first occurrence of a specific access control entry from the access control list.

The to remove from the access control list. The parameter is null.

Specifies the types of acknowledgment message that Message Queuing returns to the sending application.

A mask used to request a positive acknowledgment when the original message reaches the queue.

A mask used to request a positive acknowledgment when the original message is successfully retrieved from the queue.

A mask used to request a negative acknowledgment when the original message fails to be received from the queue.

A mask used to request that no acknowledgment messages (positive or negative) be posted.

A mask used to request a negative acknowledgment when the original message cannot reach the queue. This can happen when the time-to-reach-queue timer expires or if a message cannot be authenticated.

A mask used to request a negative acknowledgment when an error occurs that prevents the original message from being received from the queue before its time-to-be-received timer expires.

A mask used to request positive acknowledgment if the original message reaches the queue or negative acknowledgment if the time-to-reach-queue timer expires or if the original message cannot be authenticated.

A mask used to request positive acknowledgment if the original message is received from the queue before its time-to-be-received timer expires or negative acknowledgment otherwise.

Specifies the result of an attempted message delivery.

The message is not an acknowledgment message.

A negative arrival acknowledgment indicating that the sending application does not have the necessary rights to send a message to the destination queue.

A negative arrival acknowledgment indicating that the destination queue is not available to the sending application.

A negative arrival acknowledgment indicating that the destination queue manager could not decrypt a private message.

A negative arrival acknowledgment indicating that the original message's digital signature is not valid and could not be authenticated by Message Queuing.

A negative arrival acknowledgment indicating that the source queue manager could not encrypt a private message.

A negative arrival acknowledgment indicating that the original message's hop count (which indicates the number of intermediate servers) was exceeded.

A negative arrival acknowledgment indicating that a transactional message was sent to a non-transactional queue.

A negative arrival acknowledgment indicating that a non-transactional message was sent to a transactional queue.

A negative arrival acknowledgment indicating that the message was purged before reaching its destination queue.

A negative read acknowledgment indicating that the queue was deleted before the message could be read.

A negative arrival acknowledgment indicating that the original message was not delivered because its destination queue is full.

A negative read acknowledgment indicating that the queue was purged before the message could be read.

A positive arrival acknowledgment indicating that the original message reached its destination queue.

A negative arrival acknowledgment indicating that the time-to-reach-queue or time-to-be-received timer expired before the original message could reach the destination queue.

A negative read acknowledgment indicating that the original message was not received from the queue before its time-to-be-received timer expired.

A positive read acknowledgment indicating that the original message was received by the receiving application.

Serializes or deserializes primitive data types and other objects to or from the body of a Message Queuing message, using a format that is compatible with the MSMQ ActiveX Component.

Initializes a new instance of the class.

Determines whether the formatter can deserialize the contents of the message.

true if the can deserialize the message; otherwise, false. The to inspect. The parameter is null.

Creates an instance of the class that is identical to the current .

An object whose properties are identical to those of this .

Provides a utility to help serialize COM objects that implement IPersistStream and require IPersistStreamInit to be called.

An OLE object that implements IPersistStreamInit.

Reads the contents from the given message and creates an object that contains the deserialized message.

The deserialized message. The , in MSMQ ActiveX control format, to deserialize. The property of the passed as a parameter cannot be mapped to a primitive type, nor does it represent a streamed object. The body represents a stored object. The does not support deserialization of stored objects. The parameter is null.

Serializes an object into the body of the message.

The whose property will contain the serialized object. The object to be serialized into the message body. The object to serialize is neither a primitive nor a streamed object that implements the OLE IPersistStream interface. The parameter is null.

Serializes or deserializes an object, or an entire graph of connected objects, to or from the body of a Message Queuing message, using a binary format.

Initializes a new instance of the class without specifying a type style or top object assembly style.

Initializes a new instance of the class, specifying the formats of the root object and the type descriptions.

Determines how the top (root) object of a graph is laid out in the serialized stream. Determines how type descriptions are laid out in the serialized stream.

Determines whether the formatter can deserialize the contents of the message.

true if the binary message formatter can deserialize the message; otherwise, false. The to inspect. The parameter is null.

Creates an instance of the class whose read/write properties (the root object and type description formats) are the same as the current .

An object whose properties are identical to those of this , but whose metadata does not specify it to be a formatter class instance.

Reads the contents from the given message and creates an object that contains the deserialized message.

The deserialized message. The , in binary format, to deserialize. The message's property does not indicate a binary object. The parameter is null.

Gets or sets a value that defines how the top (root) object of a graph is deserialized with regards to finding and loading its assembly.

One of the values that defines the deserialization behavior.

Gets or sets a value that defines how type descriptions are laid out in the serialized stream.

A that defines the type description format.

Serializes an object into the body of the message.

The whose property will contain the serialized object. The object to be serialized into the message body. The parameter is null.

Specifies the cryptographic service providers available for validating digital signatures.

No cryptographic provider type specified.

The full RSA provider type, which supports both digital signatures and data encryption. Considered a general purpose cryptographic services provider. The RSA public-key algorithm is used for all public-key operations.

A subset of the RsaFull provider type, which supports only those functions and algorithms required for hashes and digital signatures.

A provider type that, like RsqSig, only supports hashes and digital signatures. Dss specifies the Digital Signature Algorithm (DSA) signature algorithm.

A provider type that contains a set of cryptographic protocols and algorithms owned by the National Institute of Standards and Technology.

A provider type designed for the cryptographic needs of the Microsoft Exchange mail application and other applications compatible with Microsoft Mail.

A provider type that supports the Secure Sockets Layer (SSL) protocol.

Secure transaction technology provider enterprise.

Secure transaction technology provider acquirer.

Secure transaction technology provider brand.

Secure transaction technology provider root.

Secure transaction technology provider issuer.

A is used to maintain a specific location in a when reading the queue's messages.

Closes the cursor, allowing Message Queuing to release the associated resources.

Releases all resources used by the .

Specifies the default property values that will be used when sending objects other than instances to a message queue.

Initializes a new instance of the class.

Gets or sets the type of acknowledgement message to be returned to the sending application.

One of the enumeration values. This value is used to determine the type of acknowledgment messages the system posts in the administration queue and when acknowledgments are returned to the sending application. The default is AcknowledgeTypes.None.

Gets or sets the queue that receives acknowledgement messages generated by Message Queuing.

The that specifies the administration queue used for system-generated acknowledgment messages. The default is null.

Gets or sets additional, application-specific information.

Information specific to the application. The default is 0.

Gets or sets a value that indicates whether the sender ID should be attached to the message.

true if sender ID should be attached to the message; otherwise, false. The default is true.

Gets or sets the encryption algorithm used to encrypt the body of a private message.

One of the enumeration values. The default is RC2.

Gets or sets additional information associated with the message.

An array of bytes that provides additional, application-defined information associated with the message. The default is a zero-length array.

Gets or sets the hashing algorithm used when authenticating messages or creating a digital signature for a message.

One of the enumeration values. The default is MD5.

Gets or sets an application-defined string that describes the message.

The label of the message. The default is an empty string ("").

Gets or sets the message priority, which is used to determine where the message is placed in the queue.

One of the enumeration values that represents the priority level of a non-transactional message. The default is Normal.

Gets or sets a value that indicates whether the message is guaranteed to be delivered in the event of a computer failure or network problem.

true if the message is guaranteed delivery by saving it to disk while en route; false if delivery is not assured. The default is false.

Gets or sets the queue that receives application-generated response messages.

The to which application-generated response messages are returned. The default is null.

Gets or sets the time limit for the message to be retrieved from the destination queue.

The total time, in seconds, for a sent message to be received from the destination queue. The default is .

Gets or sets the time limit for the message to reach the queue.

The time limit in seconds for a message to reach the destination queue, from the time the message is sent. The default is .

Gets the transaction status queue on the source computer.

The transaction status queue on the source computer, which is used for sending acknowledgement messages back to the sending application. The default is null.

Gets or sets a value that indicates whether the message must be authenticated before being sent.

true if the sending application requested authentication for the message; otherwise, false. The default is false.

Gets or sets a value that indicates whether a copy of the message that could not be delivered should be sent to a dead-letter queue.

true if message delivery failure should result in a copy of the message being sent to a dead-letter queue; otherwise, false. The default is false.

Gets or sets a value that indicates whether to make the message private.

true to require Message Queuing to encrypt the message; otherwise, false. The default is false.

Gets or sets a value that indicates whether a copy of the message should be kept in a machine journal on the originating computer.

true to require that a copy of a message be kept in the originating computer's machine journal after it has been successfully transmitted from the originating computer to the next step; otherwise, false. The default is false.

Gets or sets a value that indicates whether to trace a message as it moves toward its destination queue.

true if each intermediate step made by the original message en route to the destination queue will generate a report to be sent to the system's report queue; otherwise, false. The default is false.

Specifies the encryption algorithm used to encrypt the message body of a private message.

No encryption.

The value MQMSG_CALG_RC2. This is the default value for the encryption property of the Message Queuing application's message object.

The value MQMSG_CALG_RC4. This corresponds to the less secure option for the encryption property of the Message Queuing application's message object.

Specifies the privacy level of messages received by the queue.

Accepts only non-private (non-encrypted) messages.

Does not force privacy. Accepts private (encrypted) messages and non-private (non-encrypted) messages.

Accepts only private (encrypted) messages.

Uses the Windows 2000 and Windows NT access format to specify a set of common access rights that Message Queuing maps to both standard and object-specific access rights for reading, writing, and executing.

Read, write, and execute access.

Execute access.

Write access.

Read access.

No access.

Specifies the hash algorithm used by Message Queuing when authenticating messages.

No hashing algorithm.

MD2 hashing algorithm.

MD4 hashing algorithm.

MD5 hashing algorithm.

SHA hashing algorithm.

MAC keyed-hash algorithm.

Serializes or deserializes objects from the body of a Message Queuing message.

When implemented in a class, determines whether the formatter can deserialize the contents of the message.

true if the formatter can deserialize the message; otherwise, false. The to inspect.

When implemented in a class, reads the contents from the given message and creates an object that contains data from the message.

The deserialized message. The to deserialize.

When implemented in a class, serializes an object into the body of the message.

The that will contain the serialized object. The object to be serialized into the message.

Provides access to the properties needed to define a Message Queuing message.

Initializes a new instance of the class with an empty body.

Initializes a new instance of the class, using the to serialize the specified object into the body of the message.

The object to be serialized into the body of the message.

Initializes a new instance of the class using the specified formatter to serialize the specified object into the body of the message.

The object to be serialized into the body of the message. A that specifies the formatter with which to serialize the message body.

Gets or sets the type of acknowledgment message to be returned to the sending application.

One of the values, which represent both the types of acknowledgment messages the system posts in the administration queue and the conditions under which acknowledgments are returned to the sending application. The default is None. The message is filtered to ignore the property.

Gets the classification of acknowledgment that this message represents.

One of the enumeration values. The message has not been sent. This property can only be read on messages retrieved from a queue.-or-The message queue is filtered to ignore the property.

Gets or sets the queue that receives the acknowledgement messages that Message Queuing generates.

The that specifies the administration queue used for system-generated acknowledgment messages. The default is null. The message queue is filtered to ignore the property.

Gets or sets additional, application-specific information.

Information that is specific to the application. The default is zero. The message queue is filtered to ignore the property.

Gets the time that the message arrived in the destination queue.

A that represents the message's arrival time in the destination queue. The time is adjusted from GMT to the local time of the computer on which the destination queue resides. The message has not been sent. This property can only be read on messages retrieved from a queue.-or-The message queue is filtered to ignore the property.

Gets or sets a value that indicates whether the sender ID should be attached to the message.

true if the should be attached to the message; otherwise, false. The default is true. The message queue is filtered to ignore the property.

Gets a value that indicates whether the message was authenticated.

true if authentication was requested for the message when it entered the queue; otherwise, false. The message has not been sent. This property can only be read on messages retrieved from a queue.-or- The message queue is filtered to ignore the property.

Gets or sets the name of the cryptographic provider used to generate the digital signature of the message.

The name of the cryptographic provider used to generate the digital signature of the message. The default is Microsoft Base Cryptographic Provider version 1.0. The property could not be set.-or- The message queue is filtered to ignore the property. The was set to null.

Gets or sets the type of cryptographic provider used to generate the digital signature of the message.

One of the values. The default is RSA_FULL. The property could not be set.-or- The message queue is filtered to ignore the property.

Gets or sets the content of the message.

An object that specifies the message contents. The object can be a string, a date, a currency, a number, an array of bytes, or any managed object. The property is null.-or- The message queue is filtered to ignore the property.

Gets or sets the information in the body of the message.

A that contains the serialized information included in the of the message. The message queue is filtered to ignore the property.

Gets or sets the type of data that the message body contains.

The message body's true type, such as a string, a date, a currency, or a number. The message queue is filtered to ignore the property.

Gets or sets a value that indicates that some message properties typically set by Message Queuing were set by the sending application.

A defined by the application and used in conjunction with connector applications or message encryption. This allows a receiving application to interpret message properties that were set by the sending application but that are usually set by Message Queuing. The message queue is filtered to ignore the property.

Gets or sets the message identifier used by acknowledgment, report, and response messages to reference the original message.

The message identifier specified by the property of the original message. The correlation identifier is used by Message Queuing when it generates an acknowledgment or report message, and by an application when it generates a response message. The message queue is filtered to ignore the property. The is null.

Gets the intended destination queue for a message.

A that specifies the intended destination queue for the message. The message has not been sent. This property can only be read on messages retrieved from a queue.-or- The message queue is filtered to ignore the property.

Gets or sets the symmetric key used to encrypt application-encrypted messages or messages sent to foreign queues.

An array of byte values that specifies the destination symmetric key used to encrypt the message. The default is a zero-length array. The message queue is filtered to ignore the property. The is null.

Gets or sets the digital signature that Message Queuing uses to authenticate the message.

An array of byte values that specifies the Message Queuing 1.0 digital signature used to authenticate the message. The default is a zero-length array. The message queue is filtered to ignore the property. The property is null.

Gets or sets the encryption algorithm used to encrypt the body of a private message.

One of the enumeration values. The default is RC2. The message queue is filtered to ignore the property.

Gets or sets additional, application-defined information associated with the message.

An array of byte values that provides application-defined information associated with the message. The default is a zero-length array. The message queue is filtered to ignore the property. The property is null.

Gets or sets the formatter used to serialize an object into or deserialize an object from the message body.

The that produces a stream to be written to or read from the message body. The default is . The property is null.

Gets or sets the hashing algorithm that Message Queuing uses when authenticating a message or creating a digital signature for a message.

One of the enumeration values. For Windows XP, the default is SHA. Otherwise, the default is MD5. The message queue is filtered to ignore the property.

Gets the message's identifier.

The message's unique identifier, which is generated by Message Queuing. The message has not been sent. This property can only be read on messages retrieved from a queue.-or- The message queue is filtered to ignore the property.

Specifies that no time-out exists.

Gets a value that indicates whether the message was the first message sent in a transaction.

true if the message was the first message sent in a transaction; otherwise, false. The message has not been sent. This property can only be read on messages retrieved from a queue.-or- The message queue is filtered to ignore the property.

Gets a value that indicates whether the message was the last message sent in a transaction.

true if the message was the last message sent in a single transaction; otherwise, false. The message has not been sent. This property can only be read on messages retrieved from a queue.-or- The message queue is filtered to ignore the property.

Gets or sets an application-defined Unicode string that describes the message.

The label of the message. The default is an empty string (""). The message queue is filtered to ignore the property.

Introduced in MSMQ 3.0. Gets the message's lookup identifier.

The message's lookup identifier, which is generated by Message Queuing and is unique to the queue where the message resides. MSMQ 3.0 is not installed. The message has not been sent. This property can only be read on messages retrieved from a queue.-or- The message queue is filtered to ignore the property.

Gets the message type: Normal, Acknowledgment, or Report.

One of the values. The message has not been sent. This property can only be read on messages retrieved from a queue.-or- The message queue is filtered to ignore the property.

Gets or sets the message priority, which determines where in the queue the message is placed.

One of the values, which represent the priority levels of non-transactional messages. The default is Normal. The message queue is filtered to ignore the property.

Gets or sets a value that indicates whether the message is guaranteed to be delivered in the event of a computer failure or network problem.

true if delivery of the message is guaranteed (through saving the message to disk while en route); false if delivery is not assured. The default is false. The message queue is filtered to ignore the property.

Gets or sets the queue that receives application-generated response messages.

The to which application-generated response messages are returned. The default is null. The message queue is filtered to ignore the property.

Gets or sets the security context for a message.

A object that contains the security context for a message, if the property has previously been set; otherwise NULL.

Gets or sets the security certificate used to authenticate messages.

An array of byte values that represents a security certificate, which Message Queuing uses to verify the sender of the message. The default is a zero-length array. The message queue is filtered to ignore the property.

Gets the identifier of the sending user.

An array of byte values that identifies the sender. The receiving Queue Manager uses the identifier when it authenticates the message to verify the sender of the message and the sender's access rights to the queue. The message has not been sent. This property can only be read on messages retrieved from a queue.-or- The message queue is filtered to ignore the property.

Gets the version of Message Queuing used to send the message.

The version of Message Queuing used to send the message. The message has not been sent. This property can only be read on messages retrieved from a queue.-or- The message queue is filtered to ignore the property.

Gets the date and time on the sending computer that the message was sent by the source queue manager.

A that represents the time the message was sent. The message has not been sent. This property can only be read on messages retrieved from a queue.-or- The message queue is filtered to ignore the property.

Gets the computer from which the message originated.

The name of the computer from which the message was sent. The message has not been sent. This property can only be read on messages retrieved from a queue.-or- The message queue is filtered to ignore the property. The computer information or directory service could not be accessed.

Gets or sets the maximum amount of time for the message to be received from the destination queue.

The total time for a sent message to be received from the destination queue. The default is . The message queue is filtered to ignore the property. The value specified for is invalid.

Gets or sets the maximum amount of time for the message to reach the queue.

The time limit for the message to reach the destination queue, beginning from the time the message is sent. The default is . The message queue is filtered to ignore the property. The value specified for is invalid. It might represent a negative number.

Gets the identifier for the transaction of which the message was a part.

The identifier for the transaction associated with the message. The message has not been sent. This property can only be read on messages retrieved from a queue.-or- The message queue is filtered to ignore the property.

Gets the transaction status queue on the source computer.

The transaction status queue on the source computer, which is used for sending acknowledgement messages back to the sending application. The default is null. The message has not been sent. This property can only be read on messages retrieved from a queue.-or- The message queue is filtered to ignore the property.

Gets or sets a value that indicates whether the message was (or must be) authenticated before being sent.

true if the sending application requested authentication for the message; otherwise, false. The message queue is filtered to ignore the property.

Gets or sets a value that indicates whether a copy of the message that could not be delivered should be sent to a dead-letter queue.

true if message-delivery failure should result in a copy of the message being sent to a dead-letter queue; otherwise, false. The default is false. The message queue is filtered to ignore the property.

Gets or sets a value that indicates whether to make the message private.

true to require Message Queuing to encrypt the message; otherwise, false. The default is false. The message queue is filtered to ignore the property.

Gets or sets a value that indicates whether a copy of the message should be kept in a machine journal on the originating computer.

true to require that a copy of a message be kept in the originating computer's machine journal after the message has been successfully transmitted (from the originating computer to the next server); otherwise, false. The default is false. The message queue is filtered to ignore the property.

Gets or sets a value that indicates whether to trace a message as it moves toward its destination queue.

true if each intermediate step made by the original message en route to the destination queue generates a report to be sent to the system's report queue; otherwise, false. The default is false. The message queue is filtered to ignore the property.

Provides a forward-only cursor to enumerate through messages in a message queue.

Frees the resources associated with the enumerator.

Gets the current that this enumerator points to.

The current message. You called before the first call to . The cursor is located before the first element of the message enumeration.-or- You called after a call to had returned false (indicating the cursor is located after the last element of the message enumeration.) The message the enumerator is currently pointing to no longer exists. It might have been deleted.

Gets the native Message Queuing cursor handle used to browse messages in the queue.

The native cursor handle. The handle does not exist.

Releases all resources used by the .

Releases the unmanaged resources used by the and optionally releases the managed resources.

true to release both managed and unmanaged resources; false to release only unmanaged resources.

Releases the resources held by the enumerator.

Advances the enumerator to the next message in the queue, if one is currently available.

true if the enumerator was succesfully advanced to the next message; false if the enumerator has reached the end of the queue. An exception specific to Message Queuing was thrown.

Advances the enumerator to the next message in the queue. If the enumerator is positioned at the end of the queue, waits until a message is available or the given timeout expires.

true if the enumerator successfully advanced to the next message; false if the enumerator has reached the end of the queue and a message does not become available within the time specified by the parameter. The to wait for a message to be available if the enumerator is positioned at the end of the queue. The value specified for the timeout parameter is invalid. It might represent a negative number. An exception specific to Message Queuing was thrown.-or- The timeout has expired.

Removes the current message from a transactional or non-transactional queue and returns the message to the calling application. There is no timeout specified for a message to arrive in the queue.

A that references the first message available in the queue.

Removes the current message from a transactional queue and returns the message to the calling application. There is no timeout specified for a message to arrive in the queue.

A that references the first message available in the queue. The object that specifies the transaction in which the message will be removed. The parameter is null.

Removes the current message from a queue and returns the message to the calling application. There is no timeout specified for a message to arrive in the queue.

A that references the first message available in the queue. One of the values, describing the type of transaction context to associate with the message. The parameter is not one of the members.

Removes the current message from the queue and returns the message to the calling application. If there is a message to remove, the method returns it immediately. Otherwise, the method waits the specified timeout for a new message to arrive.

A that references the first message available in the queue. The interval of time to wait for a message to arrive in the queue. The value specified for the parameter is invalid. The timeout has expired.

Removes the current message from a transactional queue and returns the message to the calling application. If there is a message to remove, the method returns it immediately. Otherwise, the method waits the specified timeout for a new message to arrive.

A that references the first message available in the queue. The interval of time to wait for the message to be removed. The object that specifies the transaction context for the message. The value specified for the parameter is invalid. The parameter is null. The timeout has expired.

Removes the current message from a queue and returns the message to the calling application. If there is a message to remove, the method returns it immediately. Otherwise, the method waits the specified timeout for a new message to arrive.

A that references the first message available in the queue. The interval of time to wait for the message to be removed. One of the values, describing the type of transaction context to associate with the message. The value specified for the parameter is invalid. The timeout has expired. The parameter is not one of the members.

Resets the current enumerator so it points to the head of the queue.

Gets the current that this enumerator points to.

The current message. You accessed this property before the first call to . The cursor is located before the first element of the message enumeration.-or- You accessed this property after a call to had returned false (indicating the cursor is located after the last element of the message enumeration.) The message the enumerator is currently pointing to no longer exists. It might have been deleted.

Specifies a message to peek at or receive from a message queue.

Read the current message.

Read the following message.

Read the preceding message.

Read the first message in the queue.

Read the last message in the queue.

Specifies the priority Message Queuing applies to a message while it is en route to a queue, and when inserting the message into the destination queue.

Lowest message priority.

Between Low and Lowest message priority.

Low message priority.

Normal message priority.

Between and message priority.

High message priority.

Between Highest and High message priority.

Highest message priority.

Controls and selects the properties that are retrieved when peeking or receiving messages from a message queue.

Initializes a new instance of the class and sets default values for all properties.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is true.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is true.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is true.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is true.

Sets all Boolean filter values to false, so that no message properties are retrieved when receiving a message.

Creates a shallow copy of the object.

A that represents an instance of the class.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets the size, in bytes, of the default body buffer.

The default body buffer size to create when the message is received. The default is 1024 bytes. The assigned value is negative.

Gets or sets the size, in bytes, of the default extension buffer.

The default extension buffer size to create when the message is received. The default is 255 bytes. The assigned value is negative.

Gets or sets the size, in bytes, of the default label buffer.

The default label buffer size to create when the message is received. The default is 255 bytes. The assigned value is negative.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is true.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is true.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive property information; otherwise, false. The default is true.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is true.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is true.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Specifies to retrieve all message properties when receiving a message.

Sets the filter values of common Message Queuing properties to true and the integer-valued properties to their default values.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is true.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is true.

Gets or sets a value that indicates whether to retrieve property information when receiving or peeking a message.

true to receive information; otherwise, false. The default is false.

Provides access to a queue on a Message Queuing server.

Initializes a new instance of the class. After the default constructor initializes the new instance, you must set the instance's property before you can use the instance.

Initializes a new instance of the class that references the Message Queuing queue at the specified path.

The location of the queue referenced by this . The property is not valid, possibly because it has not been set.

Initializes a new instance of the class that references the Message Queuing queue at the specified path and with the specified read-access restriction.

The location of the queue referenced by this , which can be "." for the local computer. For information about the proper syntax for this parameter, see the Remarks section. true to grant exclusive read access to the first application that accesses the queue; otherwise, false. The property is not valid, possibly because it has not been set.

Initializes a new instance of the class.

The location of the queue referenced by this , which can be "." for the local computer. true to grant exclusive read access to the first application that accesses the queue; otherwise, false. true to create and use a connection cache; otherwise, false.

Initializes a new instance of the class.

The location of the queue referenced by this , which can be "." for the local computer. true to grant exclusive read access to the first application that accesses the queue; otherwise, false. true to create and use a connection cache; otherwise, false. One of the values.

Initializes a new instance of the class.

The location of the queue referenced by this , which can be "." for the local computer. One of the values.

Gets a value that indicates the access mode for the queue.

One of the values.

Gets or sets a value that indicates whether the queue accepts only authenticated messages.

true if the queue accepts only authenticated messages; otherwise, false. The default is false. An error occurred when accessing a Message Queuing method.

Gets or sets the base priority Message Queuing uses to route a public queue's messages over the network.

The single base priority for all messages sent to the (public) queue. The default is zero (0). The base priority was set to an invalid value. An error occurred when accessing a Message Queuing method.

Initiates an asynchronous peek operation that has no time-out. The operation is not complete until a message becomes available in the queue.

The that identifies the posted asynchronous request. An error occurred when accessing a Message Queuing method.

Initiates an asynchronous peek operation that has a specified time-out. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

The that identifies the posted asynchronous request. A that indicates the interval of time to wait for a message to become available. The value specified for the parameter is not valid. An error occurred when accessing a Message Queuing method.

Initiates an asynchronous peek operation that has a specified time-out and that uses a specified cursor, a specified peek action, and a specified state object. The state object provides associated information throughout the lifetime of the operation. This overload receives notification, through a callback, of the identity of the event handler for the operation. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

The that identifies the posted asynchronous request. A that indicates the interval of time to wait for a message to become available. A that maintains a specific position in the message queue. One of the values. Indicates whether to peek at the current message in the queue, or the next message. A state object, specified by the application, that contains information associated with the asynchronous operation. The that receives the notification of the asynchronous operation completion. A value other than PeekAction.Current or PeekAction.Next was specified for the parameter. The parameter is null. The value specified for the parameter is not valid. An error occurred when accessing a Message Queuing method.

Initiates an asynchronous peek operation that has a specified time-out and a specified state object, which provides associated information throughout the operation's lifetime. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

The that identifies the posted asynchronous request. A that indicates the interval of time to wait for a message to become available. A state object, specified by the application, that contains information associated with the asynchronous operation. The value specified for the parameter is not valid. An error occurred when accessing a Message Queuing method.

Initiates an asynchronous peek operation that has a specified time-out and a specified state object, which provides associated information throughout the operation's lifetime. This overload receives notification, through a callback, of the identity of the event handler for the operation. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

The that identifies the posted asynchronous request. A that indicates the interval of time to wait for a message to become available. A state object, specified by the application, that contains information associated with the asynchronous operation. The that will receive the notification of the asynchronous operation completion. The value specified for the parameter is not valid. An error occurred when accessing a Message Queuing method.

Initiates an asynchronous receive operation that has no time-out. The operation is not complete until a message becomes available in the queue.

The that identifies the posted asynchronous request. An error occurred when accessing a Message Queuing method.

Initiates an asynchronous receive operation that has a specified time-out. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

The that identifies the posted asynchronous request. A that indicates the interval of time to wait for a message to become available. The value specified for the parameter is not valid, possibly because it represents a negative number. An error occurred when accessing a Message Queuing method.

Initiates an asynchronous receive operation that has a specified time-out and uses a specified cursor and a specified state object. The state object provides associated information throughout the lifetime of the operation. This overload receives notification, through a callback, of the identity of the event handler for the operation. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

The that identifies the posted asynchronous request. A that indicates the interval of time to wait for a message to become available. A that maintains a specific position in the message queue. A state object, specified by the application, that contains information associated with the asynchronous operation. The that receives the notification of the asynchronous operation completion. The parameter is null. The value specified for the parameter is not valid. An error occurred when accessing a Message Queuing method.

Initiates an asynchronous receive operation that has a specified time-out and a specified state object, which provides associated information throughout the operation's lifetime. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

The that identifies the posted asynchronous request. A that indicates the interval of time to wait for a message to become available. A state object, specified by the application, that contains information associated with the asynchronous operation. The value specified for the parameter is not valid. An error occurred when accessing a Message Queuing method.

Initiates an asynchronous receive operation that has a specified time-out and a specified state object, which provides associated information throughout the operation's lifetime. This overload receives notification, through a callback, of the identity of the event handler for the operation. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

The that identifies the posted asynchronous request. A that indicates the interval of time to wait for a message to become available. A state object, specified by the application, that contains information associated with the asynchronous operation. The that will receive the notification of the asynchronous operation completion. The value specified for the parameter is not valid. An error occurred when accessing a Message Queuing method.

Gets a value that indicates whether the can be read.

true if the exists and the application can read from it; otherwise, false.

Gets a value that indicates whether the can be written to.

true if the exists and the application can write to it; otherwise, false.

Gets or sets the queue category.

A that represents the queue category (Message Queuing type identifier), which allows an application to categorize its queues. The default is Guid.empty. The queue category was set to an invalid value. An error occurred when accessing a Message Queuing method.

Clears the connection cache.

Frees all resources allocated by the .

Creates a non-transactional Message Queuing queue at the specified path.

A that represents the new queue. The path of the queue to create. The parameter is null or is an empty string (""). A queue already exists at the specified path.-or- An error occurred when accessing a Message Queuing method.

Creates a transactional or non-transactional Message Queuing queue at the specified path.

A that represents the new queue. The path of the queue to create. true to create a transactional queue; false to create a non-transactional queue. The parameter is null or is an empty string (""). A queue already exists at the specified path.-or- An error occurred when accessing a Message Queuing method.

Creates a new for the current message queue.

A new for the current message queue. This cursor is used to maintain a specific location in the queue when reading the queue's messages.

Gets the time and date that the queue was created in Message Queuing.

A that represents the date and time at which the queue was created. An error occurred when accessing a Message Queuing method.

Gets or sets the message property values to be used by default when the application sends messages to the queue.

A that contains the default Message Queuing message property values used when the application sends objects other than instances to the queue. The default properties could not be set for the queue, possibly because one of the properties is not valid.

Deletes a queue on a Message Queuing server.

The location of the queue to be deleted. The parameter is null or is an empty string (""). The syntax for the parameter is not valid.-or- An error occurred when accessing a Message Queuing method.

Gets or sets a value that indicates whether this has exclusive access to receive messages from the Message Queuing queue.

true if this has exclusive rights to receive messages from the queue; otherwise, false. The default is false.

Disposes of the resources (other than memory) used by the .

true to release both managed and unmanaged resources; false to release only unmanaged resources.

Gets or sets a value that indicates whether a cache of connections will be maintained by the application.

true to create and use a connection cache; otherwise, false.

Gets or sets a value that indicates whether the queue accepts only non-private (non-encrypted) messages.

One of the values. The default is None. An error occurred when accessing a Message Queuing method.

Completes the specified asynchronous peek operation.

The associated with the completed asynchronous operation. The that identifies the asynchronous peek operation to finish and from which to retrieve an end result. The parameter is null. The syntax of the parameter is not valid. An error occurred when accessing a Message Queuing method.

Completes the specified asynchronous receive operation.

The associated with the completed asynchronous operation. The that identifies the asynchronous receive operation to finish and from which to retrieve an end result. The parameter is null. The syntax of the parameter is not valid. An error occurred when accessing a Message Queuing method.

Determines whether a Message Queuing queue exists at the specified path.

true if a queue with the specified path exists; otherwise, false. The location of the queue to find. The syntax is not valid. An error occurred when accessing a Message Queuing method.-or- The method is being called on a remote private queue The application used format name syntax when verifying queue existence.

Gets the unique queue name that Message Queuing generated at the time of the queue's creation.

The name for the queue, which is unique on the network. The is not set.-or- An error occurred when accessing a Message Queuing method.

Gets or sets the formatter used to serialize an object into or deserialize an object from the body of a message read from or written to the queue.

The that produces a stream to be written to or read from the message body. The default is .

Returns all the messages that are in the queue.

An array of type that represents all the messages in the queue, in the same order as they appear in the Message Queuing queue. An error occurred when accessing a Message Queuing method.

Enumerates the messages in a queue. is deprecated. should be used instead.

A that provides a dynamic connection to the messages in the queue.

Gets the identifier of the computer on which the queue referenced by this is located.

A that represents a unique identifier for the computer on which the queue is located. The name of the computer that contains the queue, without the two preceding backslashes (\\). The computer identifier could not be retrieved, possibly because the directory service is not available; for example, if you are working offline.-or- An error occurred when accessing a Message Queuing method.

Creates an enumerator object for all the messages in the queue. is deprecated. should be used instead.

The holding the messages that are contained in the queue.

Creates an enumerator object for all the messages in the queue.

The holding the messages that are contained in the queue.

Provides forward-only cursor semantics to enumerate through all public queues on the network.

A that provides a dynamic listing of all the public message queues on the network.

Provides forward-only cursor semantics to enumerate through all public queues on the network that meet the specified criteria.

A that provides a dynamic listing of the public message queues on the network that satisfy the restrictions specified by the parameter. A that contains the criteria used to filter the available message queues.

Retrieves all the private queues on the specified computer.

An array of objects that reference the retrieved private queues. The computer from which to retrieve the private queues. The parameter is null or an empty string (""). An error occurred when accessing a Message Queuing method.

Retrieves all the public queues on the network.

An array of objects that reference the retrieved public queues. An error occurred when accessing a Message Queuing method.

Retrieves all the public queues on the network that meet the specified criteria.

An array of objects that reference the retrieved public queues. A that contains the criteria used to filter the queues. An error occurred when accessing a Message Queuing method.

Retrieves all the public queues on the network that belong to the specified category.

An array of objects that reference the retrieved public queues. A that groups the set of queues to be retrieved. An error occurred when accessing a Message Queuing method.

Retrieves all the public queues on the network that carry the specified label.

An array of objects that reference the retrieved public queues. A label that groups the set of queues to be retrieved. An error occurred when accessing a Message Queuing method. The parameter is null.

Retrieves all the public queues that reside on the specified computer.

An array of objects that reference the public queues on the computer. The name of the computer that contains the set of public queues to be retrieved. The parameter has incorrect syntax. An error occurred when accessing a Message Queuing method.

Retrieves the security context that MSMQ associates with the current user (thread identity) at the time of this call.

A object that contains the security context.

Gets the unique Message Queuing identifier of the queue.

A that represents the message identifier generated by the Message Queuing application. An error occurred when accessing a Message Queuing method.

Specifies that no size restriction exists for a queue.

Specifies that no time-out exists for methods that peek or receive messages.

Gets or sets the queue description.

The label for the message queue. The default is an empty string (""). The label was set to an invalid value. An error occurred when accessing a Message Queuing method.

Gets the last time the properties of a queue were modified.

A that indicates when the queue properties were last modified. An error occurred when accessing a Message Queuing method.

Gets or sets the name of the computer where the Message Queuing queue is located.

The name of the computer where the queue is located. The Message Queuing default is ".", the local computer. The is null. The name of the computer is not valid, possibly because the syntax is incorrect. An error occurred when accessing a Message Queuing method.

Gets or sets the maximum size of the journal queue.

The maximum size, in kilobytes, of the journal queue. The Message Queuing default specifies that no limit exists. The maximum journal queue size was set to an invalid value. An error occurred when accessing a Message Queuing method.

Gets or sets the maximum size of the queue.

The maximum size, in kilobytes, of the queue. The Message Queuing default specifies that no limit exists. The maximum queue size contains a negative value. An error occurred when accessing a Message Queuing method.

Gets or sets the property filter for receiving or peeking messages.

The used by the queue to filter the set of properties it receives or peeks for each message. The filter is null.

Introduced in MSMQ 3.0. Gets or sets the multicast address associated with the queue.

A that contains a valid multicast address (in the form shown below) or null, which indicates that the queue is not associated with a multicast address. Copy Code<address>:<port> MSMQ 3.0 is not installed.

Gets or sets the queue's path. Setting the causes the to point to a new queue.

The queue that is referenced by the . The default depends on which constructor you use; it is either null or is specified by the constructor's parameter. The path is not valid, possibly because the syntax is not valid.

Returns without removing (peeks) the first message in the queue referenced by this . The method is synchronous, so it blocks the current thread until a message becomes available.

The that represents the first message in the queue. An error occurred when accessing a Message Queuing method.

Returns without removing (peeks) the first message in the queue referenced by this . The method is synchronous, so it blocks the current thread until a message becomes available or the specified time-out occurs.

The that represents the first message in the queue. A that indicates the maximum time to wait for the queue to contain a message. The value specified for the parameter is not valid, possibly is less than or greater than . An error occurred when accessing a Message Queuing method.

Returns without removing (peeks) the current or next message in the queue, using the specified cursor. The method is synchronous, so it blocks the current thread until a message becomes available or the specified time-out occurs.

A that represents a message in the queue. A that indicates the maximum time to wait for the queue to contain a message. A that maintains a specific position in the message queue. One of the values. Indicates whether to peek at the current message in the queue, or the next message. A value other than PeekAction.Current or PeekAction.Next was specified for the parameter. The parameter is null. The value specified for the parameter is not valid. Possibly is less than or greater than . An error occurred when accessing a Message Queuing method.

Peeks the message that matches the given correlation identifier and immediately raises an exception if no message with the specified correlation identifier currently exists in the queue.

The whose matches the parameter passed in. The of the message to peek. The parameter is null. The message with the specified could not be found. An error occurred when accessing a Message Queuing method.

Peeks the message that matches the given correlation identifier and waits until either a message with the specified correlation identifier is available in the queue, or the time-out expires.

The whose matches the parameter passed in. The of the message to peek. A that indicates the time to wait until a new message is available for inspection. The parameter is null. The value specified for the parameter is not valid, possibly is less than or greater than . The message with the specified does not exist in the queue and did not arrive before the time-out expired. A message did not arrive before the time-out expired.-or- An error occurred when accessing a Message Queuing method.

Peeks the message whose message identifier matches the parameter.

The whose property matches the parameter. The of the message to peek. The parameter is null. No message with the specified exists. An error occurred when accessing a Message Queuing method.

Peeks the message whose message identifier matches the parameter. Waits until the message appears in the queue or a time-out occurs.

The whose property matches the parameter. The of the message to peek. A that indicates the time to wait until a new message is available for inspection. The parameter is null. The value specified for the parameter is not valid, possibly is less than or greater than . The message with the specified does not exist in the queue and did not arrive before the period specified by the parameter expired. An error occurred when accessing a Message Queuing method.

Introduced in MSMQ 3.0. Peeks at the message that matches the given lookup identifier from a non-transactional queue.

The whose property matches the parameter passed in. The of the message to peek at. MSMQ 3.0 is not installed. The message with the specified could not be found. An error occurred when accessing a Message Queuing method.

Introduced in MSMQ 3.0. Peeks at a specific message from the queue. The message can be specified by a lookup identifier or by its position at the front or end of the queue.

The specified by the and parameters passed in. One of the values, specifying how the message is read in the queue. Specify one of the following:MessageLookupAction.Current: Peeks at the message specified by .MessageLookupAction.Next: Peeks at the message following the message specified by .MessageLookupAction.Previous: Peeks at the message preceding the message specified by .MessageLookupAction.First: Peeks at the first message in the queue. The parameter must be set to 0.MessageLookupAction.Last: Peeks at the last message in the queue. The parameter must be set to 0. The of the message to peek at, or 0. 0 is used when accessing the first or last message in the queue. MSMQ 3.0 is not installed. The message with the specified could not be found. An error occurred when accessing a Message Queuing method. The parameter is not one of the members.

Occurs when a message is read without being removed from the queue. This is a result of the asynchronous operation, .

Deletes all the messages contained in the queue.

An error occurred when accessing a Message Queuing method.

Gets or sets the friendly name that identifies the queue.

The name that identifies the queue referenced by this . The value cannot be null. The queue name is null.

Gets the native handle used to read messages from the message queue.

A handle to the native queue object that you use for peeking and receiving messages from the queue. An error occurred when accessing a Message Queuing method.

Receives the first message available in the queue referenced by the . This call is synchronous, and blocks the current thread of execution until a message is available.

A that references the first message available in the queue. An error occurred when accessing a Message Queuing method.

Receives the first message available in the transactional queue referenced by the . This call is synchronous, and blocks the current thread of execution until a message is available.

A that references the first message available in the queue. The object. An error occurred when accessing a Message Queuing method.-or- The queue is non-transactional.

Receives the first message available in the queue referenced by the . This call is synchronous, and blocks the current thread of execution until a message is available.

A that references the first message available in the queue. One of the values, describing the type of transaction context to associate with the message. An error occurred when accessing a Message Queuing method. The parameter is not one of the members.

Receives the first message available in the queue referenced by the and waits until either a message is available in the queue, or the time-out expires.

A that references the first message available in the queue. A that indicates the time to wait until a new message is available for inspection. The value specified for the parameter is not valid, possibly is less than or greater than . A message did not arrive in the queue before the time-out expired.-or- An error occurred when accessing a Message Queuing method

Receives the current message in the queue, using a specified cursor. If no message is available, this method waits until either a message is available, or the time-out expires.

A that references the first message available in the queue. A that indicates the time to wait until a new message is available for inspection. A that maintains a specific position in the message queue. The value specified for the parameter is not valid, possibly is less than or greater than . A message did not arrive in the queue before the time-out expired.-or- An error occurred when accessing a Message Queuing method

Receives the current message in the queue, using a specified cursor. If no message is available, this method waits until either a message is available, or the time-out expires.

A that references a message in the queue. A that indicates the time to wait until a new message is available for inspection. A that maintains a specific position in the message queue. The object. The parameter is null.-or-The parameter is null. The value specified for the parameter is not valid. Possibly is less than or greater than . A message did not arrive in the queue before the time-out expired.-or- The queue is non-transactional.-or- An error occurred when accessing a Message Queuing method.

Receives the current message in the queue, using a specified cursor. If no message is available, this method waits until either a message is available, or the time-out expires.

A that references a message in the queue. A that indicates the time to wait until a new message is available for inspection. A that maintains a specific position in the message queue. One of the values that describes the type of transaction context to associate with the message. The parameter is null. The value specified for the parameter is not valid. Possibly is less than or greater than . The parameter is not one of the members. A message did not arrive in the queue before the time-out expired.-or- An error occurred when accessing a Message Queuing method.

Receives the first message available in the transactional queue referenced by the and waits until either a message is available in the queue, or the time-out expires.

A that references the first message available in the queue. A that indicates the time to wait until a new message is available for inspection. The object. The value specified for the parameter is not valid, possibly is less than or greater than . A message did not arrive in the queue before the time-out expired.-or- The queue is non-transactional.-or- An error occurred when accessing a Message Queuing method.

Receives the first message available in the queue referenced by the . This call is synchronous, and waits until either a message is available in the queue, or the time-out expires.

A that references the first message available in the queue. A that indicates the time to wait until a new message is available for inspection. One of the values, describing the type of transaction context to associate with the message. The value specified for the parameter is not valid, possibly is less than or greater than . The parameter is not one of the members. A message did not arrive in the queue before the time-out expired.-or- An error occurred when accessing a Message Queuing method.

Receives the message that matches the given correlation identifier (from a non-transactional queue) and immediately raises an exception if no message with the specified correlation identifier currently exists in the queue.

The whose matches the parameter passed in. The of the message to receive. The parameter is null. The message with the specified could not be found. An error occurred when accessing a Message Queuing method.

Receives the message that matches the given correlation identifier (from a transactional queue) and immediately raises an exception if no message with the specified correlation identifier currently exists in the queue.

The whose matches the parameter passed in. The of the message to receive. The object. The parameter is null.-or- The parameter is null. The message with the specified could not be found. The queue is non-transactional.-or- An error occurred when accessing a Message Queuing method.

Receives the message that matches the given correlation identifier and immediately raises an exception if no message with the specified correlation identifier currently exists in the queue.

The whose matches the parameter passed in. The of the message to receive. One of the values, describing the type of transaction context to associate with the message. The parameter is null. The message with the specified could not be found. The parameter is not one of the members. An error occurred when accessing a Message Queuing method.

Receives the message that matches the given correlation identifier (from a non-transactional queue) and waits until either a message with the specified correlation identifier is available in the queue, or the time-out expires.

The whose matches the parameter passed in. The of the message to receive. A that indicates the time to wait until a new message is available for inspection. The parameter is null. The value specified for the parameter is not valid, possibly is less than or greater than . The message with the specified does not exist in the queue and did not arrive before the time-out expired.-or- An error occurred when accessing a Message Queuing method.

Receives the message that matches the given correlation identifier (from a transactional queue) and waits until either a message with the specified correlation identifier is available in the queue, or the time-out expires.

The whose matches the parameter passed in. The of the message to receive. A that indicates the time to wait until a new message is available for inspection. The object. The parameter is null.-or- The parameter is null. The value specified for the parameter is not valid, possibly is less than or greater than . The message with the specified does not exist in the queue and did not arrive before the time-out expired.-or- The queue is non-transactional.-or- An error occurred when accessing a Message Queuing method.

Receives the message that matches the given correlation identifier and waits until either a message with the specified correlation identifier is available in the queue, or the time-out expires.

The whose matches the parameter passed in. The of the message to receive. A that indicates the time to wait until a new message is available for inspection. One of the values, describing the type of transaction context to associate with the message. The parameter is null. The message with the specified could not be found. The value specified for the parameter is not valid, possibly is less than or greater than . The parameter is not one of the members. The message with the specified does not exist in the queue and did not arrive before the time-out expired.-or- An error occurred when accessing a Message Queuing method.

Receives the message that matches the given identifier from a non-transactional queue and immediately raises an exception if no message with the specified identifier currently exists in the queue.

The whose property matches the parameter passed in. The of the message to receive. The parameter is null. The message with the specified could not be found. An error occurred when accessing a Message Queuing method.

Receives the message that matches the given identifier (from a transactional queue) and immediately raises an exception if no message with the specified identifier currently exists in the queue.

The whose property matches the parameter passed in. The of the message to receive. The object. The parameter is null.-or- The parameter is null. The message with the specified could not be found. The queue is non-transactional.-or- An error occurred when accessing a Message Queuing method.

Receives the message that matches the given identifier and immediately raises an exception if no message with the specified identifier currently exists in the queue.

The whose property matches the parameter passed in. The of the message to receive. One of the values, describing the type of transaction context to associate with the message. The parameter is null. The message with the specified could not be found. The parameter is not one of the members. An error occurred when accessing a Message Queuing method.

Receives the message that matches the given identifier (from a non-transactional queue) and waits until either a message with the specified identifier is available in the queue or the time-out expires.

The whose property matches the parameter passed in. The of the message to receive. A that indicates the time to wait until a new message is available for inspection. The parameter is null. The value specified for the parameter is not valid, possibly is less than or greater than . A message with the specified did not arrive in the queue before the time-out expired.-or- An error occurred when accessing a Message Queuing method.

Receives the message that matches the given identifier (from a transactional queue) and waits until either a message with the specified identifier is available in the queue or the time-out expires.

The whose property matches the parameter passed in. The of the message to receive. A that indicates the time to wait until a new message is available for inspection. The object. The parameter is null.-or- The parameter is null. The value specified for the parameter is not valid, possibly is less than or greater than . A message with the specified did not arrive in the queue before the time-out expired.-or- The queue is non-transactional.-or- An error occurred when accessing a Message Queuing method.

Receives the message that matches the given identifier and waits until either a message with the specified identifier is available in the queue or the time-out expires.

The whose property matches the parameter passed in. The of the message to receive. A that indicates the time to wait until a new message is available for inspection. One of the values, describing the type of transaction context to associate with the message. The parameter is null. The value specified for the parameter is not valid, possibly is less than or greater than . A message with the specified did not arrive in the queue before the time-out expired.-or- An error occurred when accessing a Message Queuing method. The parameter is not one of the members.

Introduced in MSMQ 3.0. Receives the message that matches the given lookup identifier from a non-transactional queue.

The whose property matches the parameter passed in. The of the message to receive. MSMQ 3.0 is not installed. The message with the specified could not be found. An error occurred when accessing a Message Queuing method.

Introduced in MSMQ 3.0. Receives a specific message from a transactional queue. The message can be specified by a lookup identifier or by its position at the front or end of the queue.

The specified by the and parameters passed in. One of the values, specifying how the message is read in the queue. Specify one of the following:MessageLookupAction.Current: Receives the message specified by and removes it from the queue.MessageLookupAction.Next: Receives the message following the message specified by and removes it from the queue.MessageLookupAction.Previous: Receives the message preceding the message specified by and removes it from the queue.MessageLookupAction.First: Receives the first message in the queue and removes it from the queue. The parameter must be set to 0.MessageLookupAction.Last: Receives the last message in the queue and removes it from the queue. The parameter must be set to 0. The of the message to receive, or 0. 0 is used when accessing the first or last message in the queue. The object. MSMQ 3.0 is not installed. The message with the specified could not be found. An error occurred when accessing a Message Queuing method.-or- The queue is non-transactional. The parameter is not one of the members.

Introduced in MSMQ 3.0. Receives a specific message from the queue, using the specified transaction context. The message can be specified by a lookup identifier or by its position at the front or end of the queue.

The specified by the and parameters passed in. One of the values, specifying how the message is read in the queue. Specify one of the following:MessageLookupAction.Current: Receives the message specified by and removes it from the queue.MessageLookupAction.Next: Receives the message following the message specified by and removes it from the queue.MessageLookupAction.Previous: Receives the message preceding the message specified by and removes it from the queue.MessageLookupAction.First: Receives the first message in the queue and removes it from the queue. The parameter must be set to 0.MessageLookupAction.Last: Receives the last message in the queue and removes it from the queue. The parameter must be set to 0. The of the message to receive, or 0. 0 is used when accessing the first or last message in the queue. One of the values, describing the type of transaction context to associate with the message. MSMQ 3.0 is not installed. The message with the specified could not be found. An error occurred when accessing a Message Queuing method. The parameter is not one of the members.-or- The parameter is not one of the members.

Occurs when a message has been removed from the queue. This event is raised by the asynchronous operation, .

Refreshes the properties presented by the to reflect the current state of the resource.

Resets the permission list to the operating system's default values. Removes any queue permissions you have appended to the default list.

An error occurred when accessing a Message Queuing method.

Sends an object to non-transactional queue referenced by this .

The object to send to the queue. The property has not been set.-or- An error occurred when accessing a Message Queuing method.

Sends an object to the transactional queue referenced by this .

The object to send to the queue. The object. The parameter is null. The property has not been set.-or- The Message Queuing application indicated an incorrect transaction use.-or- An error occurred when accessing a Message Queuing method.

Sends an object to the queue referenced by this .

The object to send to the queue. One of the values, describing the type of transaction context to associate with the message. The parameter is not one of the members. The property has not been set.-or- An error occurred when accessing a Message Queuing method.

Sends an object to the non-transactional queue referenced by this and specifies a label for the message.

The object to send to the queue. The label of the message. The parameter is null. The property has not been set.-or- An error occurred when accessing a Message Queuing method.

Sends an object to the transactional queue referenced by this and specifies a label for the message.

The object to send to the queue. The label of the message. The object. The parameter is null.-or- The parameter is null. The property has not been set.-or- The Message Queuing application indicated an incorrect transaction usage.-or- An error occurred when accessing a Message Queuing method.

Sends an object to the queue referenced by this and specifies a label for the message.

The object to send to the queue. The label of the message. One of the values, describing the type of transaction context to associate with the message. The parameter is null. The Message Queuing application indicated an incorrect transaction usage. The parameter is not one of the members. The property has not been set.-or- An error occurred when accessing a Message Queuing method.

Assigns access rights to the queue based on the contents of an access control list.

A that contains one or more access control entries that specify the trustees and the permissions to grant. An error occurred when accessing a Message Queuing method.

Assigns access rights to the queue based on the contents of an access control entry.

A that specifies a user, an access type, and a permission type. An error occurred when accessing a Message Queuing method.

Gives a computer, group, or user the specified access rights.

The individual, group, or computer that gets additional rights to the queue. A that indicates the set of rights to the queue that Message Queuing assigns to the passed in. The is null. An error occurred when accessing a Message Queuing method.

Gives a computer, group, or user the specified access rights, with the specified access control type (allow, deny, revoke, or set).

The individual, group, or computer that gets additional rights to the queue. A that indicates the set of rights to the queue that Message Queuing assigns to the passed in. A that specifies whether to grant, deny, or revoke the permissions specified by the parameter. An error occurred when accessing a Message Queuing method.

Gets or sets the object that marshals the event-handler call resulting from a or event.

A , which represents the object that marshals the event-handler call resulting from a or event. The default is null.

Gets a value that indicates whether the queue accepts only transactions.

true if the queue accepts only messages sent as part of a transaction; otherwise, false. An error occurred when accessing a Message Queuing method.

Gets or sets a value that indicates whether received messages are copied to the journal queue.

true if messages received from the queue are copied to its journal queue; otherwise, false. An error occurred when accessing a Message Queuing method.

Gets the native handle used to send messages to the message queue.

A handle to the native queue object that you use for sending messages to the queue. The message queue is not available for writing.

Specifies access rights for a trustee (user, group, or computer) to perform Message Queuing tasks.

Initializes a new instance of the class, granting the specified Message Queuing access rights to the specified trustee.

A that specifies a user, group, computer, domain, or alias. A bitwise combination of the values which defines the combination of rights to grant to the trustee.

Initializes a new instance of the class, with the specified trustee and Message Queuing access rights. The type of access (such as Allow or Deny) is defined by the entry type you pass in.

A that specifies a user, group, computer, domain, or alias. A bitwise combination of the values which defines the combination of rights to grant to the trustee. One of the values, which specifies whether to allow, deny, set or revoke the specified rights.

Gets or sets the set of Message Queuing-specific rights to apply to the trustee.

A bitwise combination of the members. The default is defined by the parameter passed into the constructor.

Specifies a set of object-specific access rights for operations specific to Message Queuing.

The right to delete messages from the queue.

The right to peek messages from the queue.

The right to send messages to the queue.

The right to delete messages from the journal queue.

The right to modify properties of the queue.

The right to read properties of the queue.

The right to delete the queue.

The right to read queue permissions.

The right to modify queue permissions.

The right to take ownership of the queue.

The right to receive messages from the queue. This includes the rights to delete and peek messages.

The right to receive messages from the journal queue. This includes the rights to delete and peek messages from the journal queue.

A combination of GetQueueProperties, GetQueuePermissions, ReceiveMessage, and ReceiveJournalMessage.

A combination of GetQueueProperties, GetQueuePermissions, and WriteMessage.

Full rights to the queue. A union of all other rights in the enumeration.

Filters message queues when performing a query using the class's method.

Initializes a new instance of the class.

Gets or sets the category by which to filter queues in the network.

The queues' category. The application did not set the property before reading it.

Clears all properties from being built into a filter and puts all property values into a "not set" state.

Gets or sets the lower boundary of the queue creation date and time by which to filter queues on the network.

A that specifies the lower boundary for a queue's creation date and time. The application did not set the property before reading it.

Gets or sets the upper boundary of the queue creation date and time by which to filter queues on the network.

A that specifies the upper boundary for a queue's creation date and time. The application did not set the property before reading it.

Gets or sets the label by which to filter queues in the network.

The queues' label. The application did not set the property before reading it.

Gets or sets the computer name by which to filter queues in the network.

The server name of the computer on which the queues reside. The application did not set the property before reading it.-or- The computer name syntax is invalid.

Gets or sets the lower boundary of the queue modification date and time by which to filter queues on the network.

A that specifies the lower boundary for a queue's last modification date and time. The application did not set the property before reading it.

Gets or sets the upper boundary of the queue modification date and time by which to filter queues on the network.

A that specifies the upper boundary for a queue's last modification date and time. The application did not set the property before reading it.

Provides a forward-only cursor to enumerate through messages in a message queue.

Frees the resources associated with the enumerator.

Gets the current of the enumeration.

The queue at which the cursor is currently positioned. You called before the first call to . The cursor is located before the first queue in the enumeration.-or- You called after a call to had returned false (indicating the cursor is located after the last queue in the enumeration).

Releases all resources used by the .

Releases the unmanaged resources used by the and optionally releases the managed resources.

true to release both managed and unmanaged resources; false to release only unmanaged resources.

Releases the resources held by the queue.

Gets the native Message Queuing handle used to locate queues in a network.

The native handle to the current queue. The handle does not exist. The calling code does not have browse permissions.

Advances the enumerator to the next queue of the enumeration, if one is currently available.

true if the enumerator was successfully advanced to the next queue; false if the enumerator has reached the end of the enumeration. The calling code does not have browse permissions.

Resets the cursor, so it points to the beginning of the enumeration.

Gets the current of the enumeration.

The queue at which the cursor is currently positioned.

Identifies the source of an error that occurred within the Message Queuing application and generated a exception.

Message Queuing does not return this error code.

Message text: Generic Error.

Message text: One or more of the passed properties are invalid.

Message text: The queue is not registered in the directory service.

Message text: A queue with the same pathname is already registered.

Message text: An invalid parameter passed to a function.

Message text: An invalid handle passed to a function.

Message text: The operation was canceled before it could be completed.

Message text: Sharing violation. The queue is already opened for exclusive receive.

Message text: The Message Queues service is not available.

Message text: The specified computer could not be found.

Message text: Illegal sort specified (for example, duplicate columns).

Message text: The user has an invalid user name.

Message text: No connection with this site's controller(s).

Message text: Invalid queue path name.

Message text: Invalid property value.

Message text: Invalid VARTYPE value.

Message text: The buffer supplied to MQReceiveMessage for message body retrieval was too small. The message is not removed from the queue and part of the message body that fits in the buffer was copied.

Message text: The receive or peek message time-out has expired.

Message text: MQ_ACTION_PEEK_NEXT specified to MQReceiveMessage can not be used with the current cursor position.

Message text: A message that is currently pointed at by the cursor has been removed from the queue by another process or by another call to receive the message without the use of this cursor.

Message text: The given format name is invalid.

Message text: The format name buffer supplied to the API was too small to fit the format name.

Message text: The requested operation for the specified format name is not supported.

Message text: The specified security descriptor is not a valid security descriptor.

Message text: The passed buffer for the user identifier property is too small.

Message text: The size of the buffer passed to MQGetQueueSecurity is too small.

Message text: The RPC server cannot impersonate the client application, hence security credentials could not be verified.

Message text: Access is denied.

Message text: Client does not have the required privileges to perform the operation.

Message text: Insufficient resources to perform operation.

Message text: Request failed because user buffer is too small to hold the returned information.

Message text: Could not store a recoverable or journal message. Message was not sent.

Message text: The passed buffer for the user certificate property is too small.

Message text: The user certificate is not valid.

Message text: The internal Message Queuing certificate is corrupted.

Message text: The internal Message Queuing certificate for the user does not exist.

Message text: A cryptographic function has failed.

Message text: The personal certificate store is corrupted.

Message text: The computer does not support encryption operations.

Message text: Bad security context.

Message text: Could not get the SID information out of the thread token.

Message text: Could not get the account information for the user.

Message text: Invalid MQCOLUMNS parameter.

Message text: Invalid property identifier value.

Message text: Invalid relation value in restriction.

Message text: Illegal property buffer size.

Message text: Invalid propid value in MQRESTRICTION parameter.

Message text: Illegal MQQUEUEPROPS parameter, either null or with zero properties.

Message text: Invalid property for the requested operation

Message text: Not all the required properties for the operation were specified in the input parameters.

Message text: Computer with the same name already exists in the site.

Message text: Illegal MQQMPROPS parameter, either null or with zero properties.

Message text: Directory service is full.

Message text: Internal directory service error.

Message text: Invalid object owner. For example CreateQueue failed because the Queue Manager object is invalid.

Message text: The specified access mode is not supported.

Message text: The supplied result buffer is too small.

Message text: The connected network cannot be deleted; it is in use.

Message text: No response from object owner.

Message text: Object owner is not reachable.

Message text: Error while reading from a queue residing on a remote computer.

Message text: Cannot connect to MS DTC.

Message text: Cannot import the transaction.

Message text: Wrong transaction usage.

Message text: Wrong transaction operations sequence.

Message text: Connector Type is mandatory when sending an Acknowledgment or secure message.

Message text: The Queue Manager service has been restarted. The queue handle is stale and should be closed.

Message text: Cannot enlist the transaction.

Message text: The queue was deleted. Messages cannot be received anymore using this queue instance. The queue should be closed.

Message text: Invalid context parameter.

Message text: Invalid propid value in MQSORTSET.

Message text: The label buffer supplied to the API was too small.

Message text: The list of MQIS servers (in registry) is empty.

Message text: MQIS database is in read-only mode.

Message text: The passed buffer for the Symmetric key property is too small.

Message text: The passed buffer for the Signature property is too small.

Message text: The passed buffer for the Provider name property is too small.

Message text: The operation is invalid on foreign message queuing systems.

Message text: Another MQIS server is being installed; write operations to the database are not allowed at this time.

Message text: Message Queuing-independent clients cannot serve Message Queuing-dependent clients.

Message text: The number of dependent clients served by this Message Queuing server reached its upper limit.

Message text: The.ini file for the queue in LQS was deleted because it was corrupted.

Message text: The remote machine is not available.

Message text: The operation is not supported for a WORKGROUP installation computer.

Message text: The Cryptographic Service Provider is not supported by Message Queuing.

Message text: Unable to set the security descriptor for the cryptographic keys.

Message text: A user attempted to send an authenticated message without a certificate.

DNS property is not supported as criteria to locate queues.

Message text: Unable to create a certificate store for the internal certificate.

Message text: Unable to open the certificates store for the internal certificate.

Message text: The operation is invalid for a Message Queuing services object.

Message text: Failed to grant the "Add Guid" permission to current user.

Message text: Cannot load the MSMQOCM.DLL library.

Message text: Cannot locate an entry point in the MSMQOCM.DLL library.

Message text: Failed to find Message Queuing servers on domain controllers.

Message text: Failed to join Message Queuing enterprise on Windows 2000 domain.

Message text: Failed to create an object on a specified global catalog server.

Message text: Failed to create Message Queuing configuration object with a GUID that matches the computer installation. You must uninstall Message Queuing and then reinstall it.

Message text: Unable to find the public key for computer.

Message text: The public key for the computer does not exist.

The private properties parameter value is invalid. This may be because it has a null value or has zero properties specified.

Message text: Unable to find Global Catalog servers in the specified domain.

Message text: Failed to find Message Queuing servers on Global Catalog domain controllers.

Message text: Failed to retrieve the distinguished name of local computer.

Message text: Unable to hash data for an authenticated message.

Message text: Unable to sign data before sending an authenticated message.

Message text: Unable to create a hash object for an authenticated message.

Message text: Signature of received message is not valid.

Message text: The specified message could not be found.

The exception that is thrown if a Microsoft Message Queuing internal error occurs.

Initializes a new instance of the class with serialized data.

A that holds the serialized data associated with the . A that contains the source and destination of the serialized stream associated with the .

Populates a serialization information object with the data needed to serialize the .

A that holds the serialized data associated with the . A that contains the source and destination of the serialized stream associated with the . The parameter is null.

Gets a value that describes the Message Queuing error.

The description of the Message Queuing internal error that generated this .

Gets a value that indicates the error code associated with this exception.

A that identifies the type of error Message Queuing generated.

Allows you to install and configure a queue that your application needs in order to run. This class is called by the installation utility, for example, InstallUtil.exe, when installing a .

Initializes a new instance of the class. Does not set any instance properties.

Initializes a new instance of the class, initializing the installation settings to those of an existing instance.

The component whose settings determine the property settings of the new queue installed.

Gets or sets a value that indicates whether the queue to be installed accepts only authenticated messages.

true if the queue accepts only authenticated messages; otherwise, false. The default is false.

Gets or sets the base priority that is used to route a public queue's messages over the network.

The single base priority for all messages sent to the public queue. The default is zero (0).

Gets or sets an implementation-specific queue type.

A that represents the queue category (or Message Queuing type identifier), which allows applications to categorize their queues according to how they are used. The default is Guid.empty.

Completes the installation process by committing the installation information that the method wrote to the registry. This method is meant to be used by installation tools, which automatically call the appropriate methods.

A that contains the post-installation state of the computer.

Copies the property values of a component that are required at install time for a message queue.

A to use as a template for the . The component associated with this is not a .

Gets or sets a value that indicates whether the queue accepts only private, or encrypted, messages.

One of the values that indicates the encryption level required on messages sent to the queue. The default is Optional.

Performs the installation and writes message queue information to the registry. This method is meant to be used by installation tools, which automatically call the appropriate methods.

A used to save information needed to perform a commit, rollback, or uninstall operation.

Determines whether the specified installer can handle the same kind of installation as this installer.

true if this installer and the installer specified by the parameter can handle the same kind of installation; otherwise, false. The installer to compare.

Gets or sets a description of the queue.

The label that describes the message queue. The default is an empty string (""). The is null.

Gets or sets the maximum size of the journal that is associated with the queue.

The maximum size, in kilobytes, of the journal queue, which records messages that are removed from the queue. The Message Queuing default is no limit.

Gets or sets the maximum size of the queue.

The maximum size, in kilobytes, of the queue. The Message Queuing default is no limit.

Introduced in MSMQ 3.0. Gets or sets the multicast address associated with the queue.

A that contains a valid multicast address (in the form shown below) or null, which indicates that the queue is not associated with a multicast address. Copy Code<address>:<port> MSMQ 3.0 is not installed.

Gets or sets the location of the queue that is referenced by this object.

The path that represents the location of the queue in the network. The was set to an invalid value, possibly because the syntax is not valid.-or- The is null.

Gets or sets permissions associated with the queue.

A that contains one or more access control entries that specify the trustees and permissions to grant for the queue.

Restores the computer to the state it was in before the installation, by rolling back the queue information that the installation procedure wrote to the registry. This method is meant to be used by installation tools, which automatically call the appropriate methods.

A that contains the pre-installation state of the computer.

Gets or sets a value that indicates whether the queue accepts only messages sent as part of a transaction.

true if the queue can only accept messages sent as part of a transaction; otherwise, false. The default is false.

Removes an installation by removing queue information from the registry. This method is meant to be used by uninstallation tools, which automatically call the appropriate methods.

A that contains the post-installation state of the computer.

Gets or sets a value that indicates what the installer does with the queue at uninstall time: remove it, restore it to its pre-installation state, or leave it in its current installed state.

One of the values that indicates what state to leave the queue in when the is uninstalled. The default is Remove.

Gets or sets a value that indicates whether messages that are retrieved from the queue are also copied to the associated journal queue.

true to copy messages that are retrieved from the queue to the journal queue; otherwise, false. The default is false.

Allows control of code access permissions for messaging.

Initializes a new instance of the class.

Initializes a new instance of the class with the specified access levels and the path of the queue.

One of the values. The path of the queue that is referenced by the .

Initializes a new instance of the class with the specified access levels, computer to use, queue description, and queue category.

One of the values. The name of the computer where the Message Queuing queue is located. The queue description. The queue category (Message Queuing type identifier).

Initializes a new instance of the class with the specified permission access level entries.

An array of objects. The property is set to this value.

Initializes a new instance of the class with the specified permission state.

One of the values.

Creates and returns an identical copy of the current permission object.

A copy of the current permission object.

Reconstructs a security object with a specified state from an XML encoding.

The XML encoding to use to reconstruct the security object.

Returns a new permission object that represents the intersection of the current permission object and the specified permission object.

A new permission object that represents the intersection of the current permission object and the specified permission object. This new permission object is a null reference (Nothing in Visual Basic) if the intersection is empty. A permission object to intersect with the current permission object. It must be of the same type as the current permission object.

Returns a value that indicates whether the current permission object is a subset of the specified permission object.

true if the current permission object is a subset of the specified permission object; otherwise, false. A permission object that is to be tested for the subset relationship. This object must be of the same type as the current permission object.

Returns a value that indicates whether the permission can be represented as unrestricted without any knowledge of the permission semantics.

true if the permission can be represented as unrestricted; otherwise, false.

Gets the collection of permission entries for this permissions request.

A that contains the permission entries for this permissions request.

Creates an XML encoding of the security object and its current state.

An XML encoding of the security object, including any state information.

Returns a new permission object that is the union of the current and specified permission objects.

A new permission object that represents the union of the current permission object and the specified permission object. A permission object to combine with the current permission object. It must be of the same type as the current permission object.

Defines access levels used by permission classes.

The has no permissions.

The can look at the queues that are available.

The can look at the queues that are available and send messages.

The can look at the queues that are available and read the messages in the queue.

The can look at the queues that are available, read the messages in the queue, and receive messages.

The can look at the queues that are available, read the messages in the queue, and send and receive messages.

Allows declarative permission checks.

Initializes a new instance of the class.

One of the values.

Gets or sets the queue category.

The queue category (Message Queuing type identifier), which allows an application to categorize its queues. The value is null.

Creates the permission based on the requested access levels, category, label, computer name, and path that are set through the , , , , and properties on the attribute.

A that represents the created permission.

Gets or sets the queue description.

The label for the message queue. The value is null.

Gets or sets the name of the computer where the Message Queuing queue is located.

The name of the computer where the queue is located. The value is null.

Gets or sets the queue's path.

The queue that is referenced by the . The value is null.

Gets or sets the permission access levels used in the permissions request.

A bitwise combination of the values.

Defines the smallest unit of a code access security permission set for messaging.

Initializes a new instance of the class with the specified permission access levels and the path of the queue.

A bitwise combination of the values. The property is set to this value. The path of the queue that is referenced by the object. The property is set to this value.

Initializes a new instance of the class with the specified permission access levels, the name of the computer where the queue is located, the queue description, and the queue category.

A bitwise combination of the values. The property is set to this value. The name of the computer where the Message Queuing queue is located. The property is set to this value. The queue description. The property is set to this value. The queue category (Message Queuing type identifier). The property is set to this value.

Gets the queue category.

The queue category (Message Queuing type identifier), which allows an application to categorize its queues.

Gets the queue description.

The label for the message queue.

Gets the name of the computer where the Message Queuing queue is located.

The name of the computer where the queue is located.

Gets the queue's path.

The queue that is referenced by the .

Gets the permission access levels used in the permissions request.

A bitwise combination of the values.

Contains a strongly typed collection of objects.

Adds a specified to this collection.

The zero-based index of the added . The to add.

Appends a set of specified permission entries to this collection.

An array of type objects that contains the permission entries to add.

Appends a set of specified permission entries to this collection.

A that contains the permission entries to add.

Determines whether this collection contains a specified .

true if the specified belongs to this collection; otherwise, false. The to find.

Copies the permission entries from this collection to an array, starting at a particular index of the array.

An array of type that receives this collection's permission entries. The zero-based index at which to begin copying the permission entries.

Determines the index of a specified permission entry in this collection.

The zero-based index of the specified permission entry, or -1 if the permission entry was not found in the collection. The permission entry to search for.

Inserts a permission entry into this collection at a specified index.

The zero-based index into the collection at which to insert the permission entry. The permission entry to insert into this collection.

Gets or sets the object at a specified index.

The that exists at the specified index. The zero-based index into the collection.

Performs additional custom processes after clearing the contents of the collection.

Performs additional custom processes before a new permission entry is inserted into the collection.

The zero-based index at which to insert . The new value of the permission entry at .

Performs additional custom processes when removing a new permission entry from the collection.

The zero-based index at which can be found. The permission entry to remove from .

Performs additional custom processes before setting a value in the collection.

The zero-based index at which can be found. The value to replace with . The new value of the permission entry at .

Removes a specified permission entry from this collection.

The permission entry to remove.

Provides a Message Queuing internal transaction.

Initializes a new instance of the class.

Rolls back the pending internal transaction.

The internal transaction you are attempting to roll back has not started. An internal Message Queuing error occurs.

Begins a new Message Queuing internal transaction.

The transaction has already been started. An internal Message Queuing error occurs.

Commits a pending internal transaction.

The transaction you are trying to commit has not started. An internal Message Queuing error occurs.

Releases all resources used by the .

Releases the unmanaged resources used by the and optionally releases the managed resources.

true to release both managed and unmanaged resources; false to release only unmanaged resources.

Releases the resources held by the current instance.

Gets the status of the transaction.

One of the values that indicates whether the transaction has been committed, aborted, initialized, or is pending.

Specifies the state of an internal Message Queuing transaction.

The transaction has been aborted and all participants have been notified.

The transaction has been committed and all participants have been notified.

The transaction has been initialized. It has not yet been started.

The transaction has been started. It has not yet been either committed or rolled back.

Specifies the type of a Message Queuing transaction.

Operation will not be transactional.

A transaction type used for Microsoft Transaction Server (MTS) or COM+ 1.0 Services. If there is already an MTS transaction context, it will be used when sending or receiving the message.

A transaction type used for single internal transactions.

Identifies the type of a message. A message can be a typical Message Queuing message, a positive (arrival and read) or negative (arrival and read) acknowledgment message, or a report message.

An acknowledgment message.

A normal Message Queuing message.

A report message.

Specifies a description for a property or event.

Initializes a new instance of the class, using the specified description.

The application-defined description text.

Gets description text associated with the item monitored.

An application-defined description.

Indicates whether to peek the current message in a queue, or the next message.

Peek at the current message in the queue.

Peek at the next message in the queue.

Provides data for the event. When your asynchronous peek operation calls an event handler, an instance of this class is passed to the handler.

Gets or sets the result of the asynchronous operation requested.

A that contains the data associated with the peek operation.

Gets the message associated with the asynchronous peek operation.

A that represents the end result of the asynchronous peek operation. The could not be retrieved. The time-out on the asynchronous operation might have expired.

Represents the method that will handle the event of a .

The source of the event, the . A that contains the event data.

Specifies the access mode for a at creation time.

The queue can only send messages.

The queue can only peek at messages.

The queue can peek at or receive messages.

The queue can peek at messages. It can also be purged.

The queue can receive messages. It can also be purged.

The queue can peek at, receive, or send messages.

Provides data for the event. When your asynchronous receive operation calls an event handler, an instance of this class is passed to the handler.

Gets or sets the result of the asynchronous operation requested.

A that contains the data associated with the receive operation.

Gets the message associated with the asynchronous receive operation.

A that represents the end result of the asynchronous receive operation. The could not be retrieved. The time-out on the asynchronous operation might have expired.

Represents the method that will handle the event of a .

The source of the event, the . A that contains the event data.

Represents the security context for a message in a queue.

Releases all resources used by the .

Specifies a set of standard access rights that correspond to operations common to most types of securable objects.

The right to delete the object.

The right to read the information in the object's security descriptor.

The right to modify the discretionary access control list (DACL) in the security descriptor.

The right to use the object for synchronization. This enables a thread to wait until the object is in a specific state.

The right to change the owner in the object's security descriptor.

The right to read the information in the object's security descriptor. Read is currently defined to equal ReadSecurity.

The right to read the information in the object's security descriptor. Write is currently defined to equal ReadSecurity.

The right to read the information in the object's security descriptor. On Windows 2000 and Windows NT, the security descriptor contains the security information for a securable object. It identifies the object's owner and primary group. Execute is currently defined to equal ReadSecurity.

Combines Delete, ReadSecurity, WriteSecurity, and ModifyOwner access.

Combines Delete, ReadSecurity, WriteSecurity, ModifyOwner, and Synchronize access.

No access.

Specifies a user account, group account, or logon session to which an access control entry applies.

Initializes a new instance of the class without setting any of its read/write properties.

Initializes a new instance of the class of type Unknown, setting the property to the value specified, and the to null.

The value to assign to the property. The parameter is null.

Initializes a new instance of the class of type Unknown, setting the and the SystemName properties to the values specified.

The value to assign to the property. The value to assign to the property. The parameter is null.

Initializes a new instance of the class of the specified type, setting the and the properties to the values specified.

The value to assign to the property. The value to assign to the property. A that indicates the account type of the trustee. The parameter is null.

Gets or sets the name of the trustee.

The name of the account to which the new rights will be assigned. The default is null. The property is null.

Gets or sets the computer on which to look up the trustee's account.

The local or remote computer on which the account exists. The default is null, which indicates that the name will be looked up on the local computer.

Gets or sets the type of the trustee, which identifies whether the trustee is a user, group, computer, domain, or alias.

A that indicates what type of account the trustee has on the system. The default is Unknown. The trustee type specified is not one of the enumeration members.

Specifies the type of a trustee.

The trustee type is unknown, but not necessarily invalid.

The trustee is a user.

The trustee is a group.

The trustee is a domain.

The trustee is an alias.

The trustee is a computer.

Serializes and deserializes objects to or from the body of a message, using the XML format based on the XSD schema definition.

Initializes a new instance of the class, without target types set.

Initializes a new instance of the class, setting target types passed in as an array of (fully qualified) string values.

An array of type that specifies the set of possible types that will be deserialized by the formatter from the message provided. These values must be fully qualified, for example, "MyNamespace.MyOrders, MyOrdersAssemblyName". The parameter is null.

Initializes a new instance of the class, setting target types passed in as an array of object types.

An array of type that specifies the set of possible types that will be deserialized by the formatter from the message provided. The parameter is null.

Determines whether the formatter can deserialize the message.

true if the XML formatter can deserialize the message; otherwise, false. The to inspect. Neither the nor property has been set. The parameter is null.

Creates an instance of the class whose read/write properties (the sets of target types) are the same as the current instance.

An object whose properties are identical to those of this instance, but whose metadata does not specify it to be a formatter class instance.

Reads the contents from the given message and creates an object that contains the deserialized message.

The deserialized message. The , in XML format, to deserialize. Neither the nor property has been set.-or- The instance serialized in the message body does not comply with any of the schemas represented by the types in the and properties. The parameter is null.

Specifies the set of possible types that will be deserialized by the formatter from the message provided.

An array of type that specifies the types of objects to deserialize from the message body when reading the message. The property is null.

Specifies the set of possible types that will be deserialized by the formatter from the message provided.

An array of type that specifies the types of objects to deserialize from the message body when reading the message. The property is null.

Serializes an object into the body of the message.

The whose property will contain the serialized object. The to be serialized into the message body. The parameter is null.-or- The parameter is null.

Represents a path editor control.

Initializes a new instance of the class, using the specified service provider.

A that can be used to obtain services.

Initializes a new instance of the class, using the specified UI service.

A that enables interaction with the user interface of the hosting development environment object.

Updates the path editor control when a queue path is selected.

Occurs when the control is double-clicked.

The source of the event. A that contains the event data.

Event handler for the form closing event of the queue path editor control.

A object that contains the arguments for the form closing event handler.

Event handler for the form creation event of the queue path editor control.

A object that contains the arguments for the form creation event handler.

Gets the queue path.

The path for the queue.

Selects the specified queue.

The to be selected.

Provides a user interface for selecting a message queue path.

Initializes a new instance of the class.

Edits the value of the specified message queue using the specified type descriptor context and service provider.

The new value of the message queue path. A that provides additional context information. A that the editor can use to obtain services. The message queue to edit.

Returns the editing style used by the method.

. A that provides additional context information.