2.2.1.1.1 RopLogon ROP Request Buffer

The following descriptions define valid fields for the RopLogon ROP request buffer ([MS-OXCROPS] section 2.2.3.1.1).

LogonFlags: This field contains flags that control the behavior of the logon. Individual flag values and their meanings are specified in the following table. The client MUST NOT set any unspecified flags.

Flag name

Value

Description

Private

0x01

This flag is set for logon to a private mailbox and is not set for logon to public folders.

Undercover

0x02

This flag is ignored by the server.

Ghosted

0x04

This flag is ignored by the server.<1>

SpoolerProcess

0x08

This flag is ignored by the server.

OpenFlags: This field contains additional flags that control the behavior of the logon. Individual flag values and their meanings are specified in the following table. The client MUST NOT set any unspecified flags.

Name

Value

Description

USE_ADMIN_PRIVILEGE

0x00000001

A request for administrative access to the mailbox.

PUBLIC

0x00000002

A request to open a public folders message store. This flag MUST be set for public logons.

HOME_LOGON

0x00000004

This flag is ignored.<2>

TAKE_OWNERSHIP

0x00000008

This flag is ignored.<3>

ALTERNATE_SERVER

0x00000100

Requests a private server to provide an alternate public server.

IGNORE_HOME_MDB

0x00000200

This flag is used only for public logons.

When set, this flag allows the client to log on to a public message store that is not the user's default public message store; otherwise, attempts to log on to a public message store that is not the user's default results in the client being redirected back to the user's default public message store.

NO_MAIL

0x00000400

This flag is ignored.<4>

USE_PER_MDB_REPLID_MAPPING

0x01000000

For a private-mailbox logon. This flag SHOULD<5> be set. For logons to a public folder message store, this flag is ignored.

SUPPORT_PROGRESS

0x20000000

Indicates that the client supports asynchronous processing of RopSetReadFlags, as specified in [MS-OXCMSG] section 2.2.3.10.1.<6>

EssdnSize: This field contains the size, in bytes, of the Essdn field.

Essdn: In the case of a private mailbox logon, this field contains an ASCII string that uniquely identifies a mailbox to log on to. In the case of a public folder logon, this field SHOULD<7> contain an ASCII string that uniquely identifies the public folder mailbox to log on to. The string value contained in the Essdn field includes the terminating NULL character. The string length (including the terminating NULL character) MUST be equal to the value specified by the EssdnSize field. If the value of the EssdnSize field is 0x00, the Essdn field is empty.

In a private mailbox logon, the string to be used in this field is the value of the legacy distinguished name (DN) attribute of the user object that is obtained by using the Autodiscover Publishing and Lookup Protocol, as specified in [MS-OXDSCLI]. In a public folder logon, the string to be used in this field is the value of the legacy DN attribute for the public folder mailbox that is obtained by either using the Autodiscover Publishing and Lookup Protocol or from the response of the RopGetOwningServers ROP (section 2.2.1.6), the RopOpenFolder ROP ([MS-OXCFOLD] section 2.2.1.1), or the RopCreateFolder ROP ([MS-OXCFOLD] section 2.2.1.2), which all return the legacy DN of the mailbox containing the public folders contents.

Show: