Export (0) Print
Expand All

IMsgStore::StoreLogoff

Published: July 16, 2012

Enables the orderly logoff of the message store.

HRESULT StoreLogoff(
  ULONG FAR * lpulFlags
);

lpulFlags

[in, out] A bitmask of flags that controls logoff from the message store. On input, all flags set for this parameter are mutually exclusive; a caller must specify only one flag per call. The following flags are valid on input:

LOGOFF_ABORT

Any transport provider activity for this message store should be stopped before logoff. Control is returned to the caller after activity is stopped. If any transport provider activity is taking place, the logoff does not occur and no change in the behavior of the MAPI spooler or transport providers occurs. If transport provider activity is idle, the MAPI spooler releases the store.

LOGOFF_NO_WAIT

The message store should not wait for messages from transport providers before closing. Outbound messages that are ready to be sent are sent. If this store contains the default Inbox, any in-process messages are received, and then further reception is disabled. When all activity is complete, the MAPI spooler releases the store, and control is immediately returned to the caller.

LOGOFF_ORDERLY

The message store should not wait for information from transport providers before closing. Messages that are currently being processed are completed, but no new messages are processed. When all activity is complete, the MAPI spooler releases the store, and control is immediately returned to the store provider.

LOGOFF_PURGE

The logoff should work the same as if the LOGOFF_NO_WAIT flag is set, but either the IXPLogon::FlushQueues or IMAPIStatus::FlushQueues method for the appropriate transport providers should be called. The LOGOFF_PURGE flag returns control to the caller after completion.

LOGOFF_QUIET

If any transport provider activity is taking place, the logoff should not occur.

The following flags are valid on output:

LOGOFF_INBOUND

Inbound messages are currently arriving.

LOGOFF_OUTBOUND

Outbound messages are in the process of being sent.

LOGOFF_OUTBOUND_QUEUE

Outbound messages are pending (that is, they are in the Outbox).

S_OK

The logoff completed successfully.

The IMsgStore::StoreLogoff method exerts control over the interaction of the message store and transport providers during the logoff process. Calling StoreLogoff is valid only for message stores that are being used only by the caller. For example, when two clients are using the same message store and one of them calls StoreLogoff, the message store is immediately released and control is returned to the calling client.

Save the flags that are passed to StoreLogoff and pass them when you call the IMAPISupport::StoreLogoffTransports method. Do not call StoreLogoffTransports until the message store's reference count drops to zero. Multiple calls to StoreLogoffTransports simply overwrite the saved flags.

If no call has been made to StoreLogoff before the message store's reference count reaches zero, set the LOGOFF_ABORT flag in the ulFlags parameter that you pass to StoreLogoffTransports.

Community Additions

ADD
Show:
© 2014 Microsoft