Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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

plJournalQuotaor 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.JournalQuotais used along with MSMQQueueInfo.Journalto 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.JournalQuotaproperty and call the MSMQQueueInfo.Createmethod.

To reset the maximum size of the queue journal, set MSMQQueueInfo.JournalQuotato a new level and call the MSMQQueueInfo.Updatemethod. 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.Refreshmethod and inspect the MSMQQueueInfo.JournalQuotaproperty.

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
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later