MSMQQueueInfo.JournalQuota

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This property specifies the maximum size, in kilobytes, of the queue journal.

Syntax

HRESULT get_JournalQuota( 
  long* plJournalQuota 
);
HRESULT put_JournalQuota( 
  long lJournalQuota
);

Parameters

• plJournalQuota or lJournalQuota
  Maximum size, in kilobytes, of the queue journal. The default is INFINITE.

Return Value

The following table describes the common return values.

Remarks

MSMQQueueInfo.JournalQuota is used along with MSMQQueueInfo.Journal to request target journaling.

Setting and Retrieving the Journal Quota

To specify the maximum size of the queue journal when creating a destination queue, set the MSMQQueueInfo.JournalQuota property and call the MSMQQueueInfo.Create method.

To reset the maximum size of the queue journal, set MSMQQueueInfo.JournalQuota to a new level and call the MSMQQueueInfo.Update method. This method updates the queue information stored by Message Queuing.

For public queues, this information is stored in the directory service.

For private queues, this information is stored on the computer where the messages of the queue are stored.

To retrieve the stored maximum size of a queue journal, call the MSMQQueueInfo.Refresh method and inspect the MSMQQueueInfo.JournalQuota property.

Equivalent Function Property

When using function calls, the maximum size of the queue journal can be set and retrieved using PROPID_Q_JOURNAL_QUOTA.

Requirements