MSMQQueueInfo.JournalQuota (Compact 2013)

3/26/2014

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.

Value

Description

S_OK

Success

E_INVALIDARG

One or more arguments are invalid

E_NOTIMPL

The function contains no implementation

E_OUTOFMEMORY

Out of memory

Remarks

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

Header

mqoai.h

Library

mqoa.lib

See Also

Reference

MSMQQueueInfo